Rewrite inline comments to make use of jsDoc #239
Description
jsDoc is terrific and well-supported, makes reading the code itself easier and allows the creation of full API docs with trivial effort. We should endeavour to rewrite all inline comments using jsDoc.