Add standard in-code documentation

[jmetz]

Recommendation

Use jsdoc (or if typescript migration is on the cards, ts equivalent such as typedoc) as mentioned here : #511 (comment)