Documentation clarity

Just documenting with a few things that I thought were a little non-obvious to someone getting started.