Update documentation - testing/development

 * add sphinx_rtd_theme theme to dev requirements
 * change theme to sphinx_rtd_theme
 * fix section headers - use chapters where needed
 * refresh documentation where needed
 * add docs on development and testing

Additionally remove incorrect comment from code.