Forget the image of the lone developer, sitting alone in a room coding on a Matrix-like black and green screen. No matter the code produced, developers need to be not only good oral communicators, they must also be able to write well. But we all struggle to use the language correctly and in a business where teams have developers with different native languages (my first language is Portuguese) we all need some help. In this post, I 'll provide an overview of some techniques and tools that developers (or anyone else!) can use to write better texts. Why is writing so important? Do you think a developer only writes code? Communicating with clients/partners via email, giving updates in bug trackers and stories, writing the stories themselves, creating documentation, comments and help files... These are all responsibilities of a software developer. Even writing easy to understand code is communicating well! A few initial tips You 're not writing a novel Don 't go overboard with the language used. Keep it as simple as possible but don 't shy away from technical terminology if that 's the correct level for the document. Know your audience Write at the correct level of detail and with the correct terminology for your audience. Don 't write development details on a user guide or marketing pitches on the API documentation. Understand the problem before writing Confused minds write confusing documents. Understand the problem and draft everything you want to include…
When it comes to finding the right words to say, I have trouble: being either too complicated or too simple. There are many grammar checkers on the web, and some of them want a person to have a certain percentage of vocabulary words. Others tell you that an expression is too complex, (usually the same words!) I try to keep a balance between both and only pull out a thesaurus when I notice I am repeating a phrase too much. Though the phrase ‘an expert’ does appear rather frequently in the “What…
from actually learning. That the use of social media is creating a generation of users who lack grammar or proper sentence structure. In her article “Our Semi-Literate Youth? Not So Fast?” Andrea Lunsford sheds some understanding of why these misconceptions exist. Through years of intense research, she ultimately concludes that technology is here to stay, that naysayers should not jump to the conclusion that it is intellectually damaging. Rather, they should understand…
Don’t Get Caught Making These 10 Common Writing Mistakes, Or Else I know, right? Rules sometimes hinder creativity. This is the reason why some writers don’t like to follow rules on grammar and sentence construction. It’s so hard to play with words if you have to think about the restrictions. But if you 're writing a book or a formal paper, then you need to stick to the rules. There’s no other way to do it since you 're writing for a larger audience and much more formal audience. Now, if you…
With adding technology to the classroom these disorders can be very helpful to students who suffer from these disorders. Different example are Spell Check, Grammar Check, online dictionaries, audio books and Paper Rater. I personally know the struggle of having difficulty reading and writing. I know having these resources have truly helped me in both reading and writing. Before I always had issues with my spelling and it would really effect my grades, when we were able to use computers and the…
There are many ways people define the term “laziness”. For example, as we discussed in class, we touched on how the older generations describe the younger generations as lazy due to the advances in technology that make what was once a difficult task an easy one to complete and out of jealousy. Laziness is viewed by many people as a negative characteristic to have, but after reading and analyzing Christopher Morley’s essay, we see how he views “laziness” and how he uses syntax and satire to…
I want to preface my discussion with firstly expressing gratitude for being one of several news outlets that strive to keep the audience informed during the presidential race. This year has been without a doubt an exciting one for both news consumers and journalists alike. Never before have we witnessed what is arguably one of the most influential positions in the world be challenged by two individuals that are not particularly liked by many people. New York Times has not only been one of my…
First Website: www.factcheck.org This is personally one of my most frequented websites because of the last election period. Factcheck.org is one of the oldest fact checking websites on the Internet today. Since starting in 2003, the website has made it a part of their mission statement to “increase public knowledge and understanding” so that viral and false rumors don’t run rampant in our society. Because of their goal to boost awareness, the website has always been very transparent about where…
paragraphs so that, with this new fresh perspective, I can alter them to make the paragraphs and ideas flow better! By no means am I perfect at this part of the writing process and having a more organized and less organic revision process is one area that I would like to improve. Due to word processing programs and the spell check feature, the art of writing is not quite as labor intensive as it used to be. Using a quill pen by candlelight and spending hours re-writing an entire page due to one…
A Pentadic Analysis When analyzing a pentad, numerous approaches can be taken, depending upon one 's intent. The terms are simplistic and easy to understand, yet their range is far. All terms are necessarily ambiguous, because they overlap into one another. Through the use of a pentadic analysis I will discuss three distinct issues. First, I will define the five pentadic elements of an analysis of the artifact. Second, I will weigh the five elements against one another and identify the…