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 makes the sentence longer and more complicated. What is the value of this change?