minor documentation
documentation cleanup so that Intellij documentation lookup shows the docs. Makes browsing code easier.

Conflicts:
	term.coffee
improvements in social book UI, to remove some exceptions that break the UI.
minor minor syntax issues