Architectural doc updates

Moved the glossary to the top to help lay some of the terminology
down at the beginning.  Also added information about yips, which
will serve as the term for interfaces that a paw can implement.