doc: Added indexing and did a bit of cleanup.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
doc: Updated for glossary terms and added indexing.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>