Best Documentation and Publishing tools for Developers

As a developer, one of the biggest tasks is documentation not even the code you write. You might have an open source project that you will want others to contribute to but they can only contribute most at times if there is a documentation,being it PDF format or web format. Another worry can be writing a book but you do not know which tool to use. Well , that is what this article addresses; showing you tools you can use for documenting or publishing. So let’s talk about documentation and publishing tools for developers.

Why would a tool like Microsoft word not help you as a documentation and publishing tool ?

The short and simple explanation is that writing documentation most at times requires that you write code snippets to show how a project works, especially when it comes to syntax highlighting. So Word is not the best choice for you.

As described on their website, haroopad is a markdown enabled document processor for creating web-friendly documents.

You can write documents of various types ranging from blog posts, slides, presentations, reports, email and more. Most of my articles are usually done with Haroopad offline before I take them online. The requirement for Haroopad is a knowledge of Markdown and it supports Github flavored markdown as well.

Since haroopad uses basically markdown, you have the joy of synta highlighting wth your programming language of choice. Other features include;

Jekyll like Mkdocs, is a static site generator but this one is based on Ruby. It is built by the co-founder of Github so you can only imagine how cool that is.Jekyll like Mkdocs can be hosted on Github Pages and Amazon S3 as well. So, you can dive into this documentation tool and get the most out of it.

Hugo is a static site generator like Jekyll and Mkdocs. But well, and it is faster as far as the build process is concerned compared to Jekyll. This tool is based on Go language. It has a set of themes you can choose from as well. Try Hugo today it is a great documentation tool…