[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.
Merge pull request #1544 from wsargent/patch-5

[doc] Update documentation README to be more accurate