WIP documentation outline (current and ideal mixed together)

Click "View file" to see it marked up. Suggestions/Discussion welcome!

Provides a rough outline of the existing codebase with some TODO tweaks.