Merge pull request #288 from alex/more-docs

Improved the docs -- more glossary entries, more advice for writing docs