Mention the mkdocs.yml file for adding new documents

and move the complicated discussion about branches lower down,
hopefully most won't need to know

Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>

@fredlf @jamtur01 @ostezer
This needs formatting:

~~~
> **Warning:**
> When *reading* ..
> ...
> ..
~~~