[doc] Update documentation README to be more accurate

The README was not accurate about the packaging of documentation and how rendering of documentation was done internally.  Added some notes to about the main SBT project and the DocumentationServer.