When working with or mentoring other developers, one problem I’ve noticed is that many developers can’t write to save their life. This goes beyond “poorly documented” or whether grammar they get wrong (such as when writing in a second language). The main problem is one of organizing thoughts for a purpose and communicating them to an audience. This is something that everyone struggles with sometimes.

Most organizations, readers, and even managers don’t expect perfect grammar or prose from technical people. What they, or any reader, expect is that you get your point across clearly and in a manner they can understand. Learning to do this can often be the difference between being the leaders in a development organization and the folks that get tasked with all of the dreaded maintenance code.

If you break down the writing task as follows, you’ll be better at communicating—and convincing—through your writing.


The first step in any writing, technical or otherwise, is to think about the purpose. Generally for developers, it is something like “explain what this piece of software does and why.” Sometimes it is “persuade someone that my approach is the best one.” Out of this usually comes a general outline of the idea you are pushing.

Source link

If you are looking to make money from running your own business at home, visit the links below.

Computers and Software Buyers Guide

Compare Computers and Laptops

  • Compare Mobile Phone Accessories
  • Compare Smart Watches
  • Compare All in One Printers
  • Compare Fax Machines
  • Compare Home Telephones
  • Compare Home Telephone Accessories
  • Game Console Buying Guide

    Compare Game Consoles

    Tech Shop Offers

    Shop Categories