Dojo uses a custom inline comment syntax which produces well structured xml, and powers the official API Docs . The doc system is powered by js-doc-parse. To get up and running quickly, check out this quickstart tutorial . For full js-doc-parse documentation, see https://github.com/wkeese/api-viewer/blob/master/README.rst .
Previously, the API docs were powered by the doctools directory. However, this is now deprecated and will be removed in 2.0.
The migration directory contains scripts for helping to migrate from older versions of dojo to newer ones.