Skip to main content

Posts

Showing posts from February, 2018

Missing documentation, a way for one developer to insult another developer

Missing documentation, a way for one developer to insult another developer Setting up a "Hello World" project should never be a nightmare, but time and again I run into instances where a "Getting Started" project has a invisible "requirement", or steps which are not documented or they are assumed to be must know even before a "hello world" sample project. My expectations for "Getting Started" is, it should contain entire step by step instructions. Strangely some developers while writing documentations, skip the requirement altogether and others link to documentation manual with no clear indication as to after landing on the fifty page document, one is suppose to read. Why has it become a mandatory approach of developers, that because I suffered, others who follow in my foot steps should also suffer. It feels like as a web developer we are yet to evolve. It was interesting to hear about the perspective from one of the colleague t