3 Ways to Create a Documentation for Any Project

3 Ways to Create a Documentation for Any Project
This post was published on the now-closed HuffPost Contributor platform. Contributors control their own work and posted freely to our site. If you need to flag this entry as abusive, send us an email.

The idea of creating a documentation and/or readme files for your projects is nothing new, in many cases - it's essential, because without a good overview of what your program and/or software does: it becomes useless to 95% of the population! Have you ever avoided creating a documentation file?

I really like how GitHub is tackling this problem, for every GitHub project - there is an automatically generated README file (mind you, it's empty at first) that needs to be populated with information, such as code snippets and demo usage. Take a look at this demo.

It won't just improve your workflow, or productivity. Learning to create documentations (using accessible 3rd-party services) is going to have a great effect on how good you are as a programmer, and also deepen your understanding of whatever it is that you're working on. Right, lets take a look at our options.

Daux.io

2014-10-08-dauxio.png

Daux.io is an documentation generator that uses a simple folder structure and Markdown files to create custom documentation on the fly. It helps you create great looking documentation in a developer friendly way. It's totally Git friendly, and has some great features like Google Analytics integration, and it's totally built on Bootstrap, giving you that designing freedom!

Flatdoc

2014-10-08-flatdoc.png

Flatdoc is a small JavaScript file that fetches Markdown files and renders them as full pages. Essentially, it's the easiest way to make open source documentation from Readme files. It really isn't that bad, and just like Daux - it's fully compatible with GitHub. You're only required to add the .js file to your pages, everything else is magic!

Documenter

2014-10-08-documenter_v_20_by_revaxartscom.png

The Documenter offers a way to generate documentations for authors of Envato marketplaces. I know a few developers and designers who're into building stuff for the greater population. It takes time to produce good documentation for Envato sites, so use this tool to take away those challenges. Building should be fun, and this tool will help it make so.

Popular in the Community

Close

What's Hot