more documentation enhancements

Outline for a glossary, small readme changes