, , , , ,

I found this this article somewhere in the blogs I follow. I think it contains, in addition to a great dose of humor, many interesting points about how important is to have good written communication skills. No matter what kind of job you are doing in a company, your grammar and spelling competence is always important.

The article says, referred to programming:

…code is prose. Great programmers are more than just code monkeys; according to Stanford programming legend Donald Knuth they are “essayists who work with traditional aesthetic and literary forms.” The point: programming should be easily understood by real human beings — not just computers.


I would add that code is not all what a programmer writes and that those other documents are as important as the code. Bug reports, functional requirements, user documentation, task reports, … are common information vehicles that are transferred as documents: mails, forms, text documents, slide presentations, manuals… Should we consider them poetry that connects with their audiences? I am not referring now only to proper grammar, writing should be well structured, clear, technical to the appropriate level depending on the readers and complete as providing all the information expected and available supporting data, respecting the mandatory confidentiality level.

The article mentions also two interesting websites, owned by the author of the article, that I think are worth a visit. The first of them is a repository of Repair guides to assist people to do their own fixing of damaged devices. The second is a Software Tool to help companies with their user documentation.

I hope you enjoy it as much as I have.