I experimented a bit with jsdoc to allow documenting the API of Evolution and its extension mechanisms. It uses the comments on the methods and classes to generate an HTML documentation. Since some parts of our code, especially the extensible ones, are documented and explaining using those tags, we could use jsdoc to produce a human readable documentation for survey developers to read.

This would also highlight the lacks of our doc and encourage us to better document our public facing classes and functions.