Module level doc strings are sparse / all contained in usage docs

[daspecster]

These docstrings end up being the landing page on the JSON Doc site.

What we have now is pretty sparse.

[daspecster]

closed by #2267.