Fix readme (see #10687) (rebased onto develop)



This is the same as gh-327 but rebased onto develop.

----

Update the Readme to describe the new structure after doc reorganization as well as the new build commands. /cc @mtbc