Consider again per module markdown doc files

[jfroelich]

Maybe at least provide some minimal basic md files per folder that describe the folder or the module within it.

Still not sold an any kind of automatic javascript doc.

I really want to move away all the misc commentary in the source, there is way too much