I've pushed the doc changes onto the install-doc-overhaul branch.
Feel free to merge if you are happy with it.

-- 
Pierre Neidhardt
https://ambrevar.xyz/