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