Home | About | Sematext search-lucene.com search-hadoop.com
 Search Hadoop and all its subprojects:

Switch to Threaded View
Hive >> mail # dev >> Moving HCatalog docs to wiki


Copy link to this message
-
Re: Moving HCatalog docs to wiki
Thanks, Carl.  I like your plan.  The main thing I liked about my plan was
that I could do it myself right away, without waiting for anyone to commit
site patches.  I figured we could reorganize later, but it's better to do
things right the first time.  Come to think of it, I don't have to wait for
tab changes before adding docs to the Hive wiki.

Does my outline for the Hive wiki fit the bill?  Or should HCatalog docs be
parceled out among existing Hive topics?  (Installation in Admin docs, and
so on.)  If necessary, an HCatalog overview page could show where to find
everything.

– Lefty

On Wed, May 15, 2013 at 6:17 PM, Carl Steinbach <[EMAIL PROTECTED]>wrote:

> 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 <[EMAIL PROTECTED]
> >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
> >
>