We should settle on some sort of in code documentation style and generator.
For a generator there is the popular JSDoc. Or we could even use Doxygen or Sphinx
The style probably also depends on the generator we chose, but we should specify it so that all documentation looks the same