Docs updates

Adds docs on using private repos with yotta
Fixes some typos and tweaks styles slightly