hive-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Edward Capriolo <>
Subject Re: DISCUSS: Hive language manual to be source control managed
Date Mon, 02 Sep 2013 22:15:24 GMT
I think that pages with only syntax that do not reference a source table or
show results are not very useful to me.

This page is nice:

This page is not nearly as useful:

I just do not think we can get a consistent feel and style.

Also for reference, I think the lateral view syntax is out of date because
we no longer require the AS.

On Mon, Sep 2, 2013 at 5:05 PM, Lars Francke <> wrote:

> > The page that strikes me as alarmingly poor is the:
> >
> The correct link is:
> <>
> For some reason there is an "Auto Export" Plugin which exports all
> Confluence pages as static HTML. That process is apparently broken.
> Unfortunately those pages appear as the top results in Google.
> > The language manual is in very poor shape at the moment with broken
> links,
> > incorrect content, incomplete content, and poor coverage of the actual
> > languages. IMHO the attempts to crowd-source this documentation has
> failed.
> > Having a good concise language manual is critical to the success and
> > adoption of hive.
> I agree. A few people try to keep up the documentation but as long as
> patches are accepted without any documentation this situation won't
> improve no matter the format of the documentation. Often not even the
> JIRA issues even mention the actual changes, you have to dig in the
> source code to find the new features/settings. I assume that a lot of
> communication happens offline.
> So one big step forward would be to not commit any feature changes
> without documentation in the Wiki or at least a clear and up to date
> description of the change in the JIRA.
> Cheers,
> Lars

View raw message