Some documentation comments based on my experience

[alanmoo]

This probably needs some refinement (there's a lot of "maybe"), but I wanted to get my observations/experiences down while still fresh.

[xmatthewx]

:clap: Welcome to the project @alanmoo!