jGrouseDoc Overview

See jGrouseDoc manual here

jGrouseDoc has the following features:

  • Documentation is produced from javadoc-style comments that are already familiar to many developers
  • Allows documenting of Javascript classes, regardless which approach or framework is being used for it - be it Prototype, Dojo, Dean Edward's Base, jGrouse or any other.
  • Allows documenting multiple interfaces for the same function. In Java you can declare several functions with different parameter set, but it is not the case in Javascript - instead developers need to put certain logic into the function to distinguish between alternate calls.
  • Allows documenting Javascript namespaces. Nothing new, for example Natural Docs also has such feature, but jGrouseDoc provides developers with higher flexibility when documenting objects in those namespaces
  • Allows documenting of artefacts that are not directly supported by Javascript, for example interfaces
  • The output is highly customizable. The rendering is based on XSL Transformation, so users can simply modify appropriate XSL template.
  • The tool is implemented as Ant task, so it could be easily integrated with existing build environment. If there would be a demand, then later it would be possible to build a standalone tool and Maven plugin.

For the details see the documentation for jGrouseDoc and also examples included with the distribution.

jGrouseDoc is an open source project distributed under modified BSD license from Google Code. Your comments and suggestions are very welcome, please send me a note to denis@jgrouse.com.