Add to docs

Hi Paul. Here are my suggestions to make the docs a bit more clear for newcomers. This would have saved me a lot of time and confusion and I'm sure will save time for other people as well.