add description, clarify status of asset dir, remove deprecated HTML tags
remove deprecated tt tag, tweak styles for code and pre inside of aside, add a few markdown generated table of contents
remove old file
merge from upstream
Merge pull request #348 from sethladd/pub-docs

Doc tweaks