Consider using Doxygen for code documentation

[i-ky]

Doxygen can automatically generate HTML documentation of source code based on comments of a specific format. Docs can be generated locally for any branch you are currently working on and it is even possible to use Travis CI to automatically generate docs for master branch and publish it in GitHub Pages like described here and here. This should make life of potential contributors substantially easier.