Making documentation easy and funny v1 "I start a blog to improve my English. I appreciate your help to check my grammar" I know, that sounds impossible but we must find ways to make our lives as easy as possible in this important topic. Being honest, documentation could be at least more easy but funny not to much. It will be funny when you could generate documentation with a simple instruction. Documentation is the most boring activity a developer can do. Maybe because it can’t be compiled or executed (I have heard this before), things developers are familiar with. Additionally users do not read documentation or manuals, so developers feel they are doing something no one will use. In my point of view there are two kinds of documentation: 1. Document what you learn This must be the most important for a developer because it represent what developer have learned, best practices, etc. Things that must be documented to not forged. Especially because developer hate do repetitive task. This kind of documentation is by the developer to himself, so it must not be boring. 2. Document what you do This kind of documentation makes reference to designs, decisions and reasons of why something was made on that way. This documentation must be done while product or system is being developed. Make documentation after software has been finished has not sense. ## Document what you have learned I prefer document knowledge instead of specific functionality, It makes me understand better a topic and record important aspects I probably will forget. Do not waste time writing documentation or summary a topic in a local file in you computer. Prefer on line tools like wikis and blogs. You can access them and modify information at any time from any place. Moreover those notes can be useful for other developers like you, who can give you feed back. Furthermore these blogs and wikis improve your skills and CV. imagine what a employer will think about a persons who has a blog with interesting topics and some followers, you demostrate skills and knowledge about something. Surely he will think you are a good candidate. There are a lot of open source tools you can install or subscribe like: * [Ghost](https://ghost.org/) * [Dropplets](http://dropplets.com/) * [DokuWiki](https://www.dokuwiki.org/) * [MediaWiki](http://www.mediawiki.org/) These are some online free platforms you can use: * [Wordpress](http://wordpress.com/) * [Tumblr]https://www.tumblr.com