Hi Lefty,

I think we should do the following:

1) Move the HCatalog wiki pages from the HCatalog space to the Hive space.
(Here's the relevant Confluence doc that explains how to do this:
https://confluence.atlassian.com/display/CONF20/Moving+a+family+of+pages+from+one+space+to+another
)

2) Convert the HCatalog xdocs to wikidocs and add them to the Hive wiki
space.

3) Remove the "HCatalog" and "HCatalog Wiki" tabs from the Hive webpage.

4) Update the description of Hive that appears on the website to include
some information about HCatalog.


Thanks.

Carl


On Wed, May 15, 2013 at 1:55 AM, Lefty Leverenz <le...@hortonworks.com>wrote:

> Now that HCatalog is part of Hive, its documentation must be converted from
> xdocs to wikidocs before we can make revisions and additions.
>
> Currently HCatalog has its own tab on the Hive website, and the HCatalog
> wiki has another tab.  HCatalog user docs (and WebHCat user/reference docs)
> could be added to either the Hive wiki or the HCatalog wiki.  You can find
> the old xdocs here:  http://hive.apache.org/docs/hcat_r0.5.0/.
>
> Since an HCatalog wiki tab already exists, I suggest putting the
> HCatalog/WebHCat docs there and pushing the existing wikidocs down a level,
> something like this:
>
>    - HCatalog Wiki Home
>       - HCatalog User Guide
>       - WebHCat Documentation
>          - User Guide
>          - Reference
>       - Developer Documentation *(existing wikidocs)*
>
> Then the Hive wiki's home page could have links to the HCatalog docs, such
> as this:
>
>    - Wiki Home
>       - Apache Hive
>       - General Information about Hive
>       - User Documentation
>       - HCatalog Documentation
>          - HCatalog User Guide *(just a link to HCatalog wiki)*
>          - WebHCat Documentation *(just a link)*
>          - HCatalog Developer Documentation *(just a link)*
>       - Administrator Documentation
>       - Resources for Contributors
>
> The Documentation page in the Project tab should also be improved with
> links to the Hive wiki and HCatalog wiki.  And for convenience, the
> HCatalog wiki's home page should have links back to the Hive home page and
> the wiki.
>
> Does anyone have a better plan?  Suggestions?  Caveats?
>
> – Lefty Leverenz
>

Reply via email to