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

Switch to Plain View
Hive >> mail # user >> DISCUSS: Hive language manual to be source control managed


Copy link to this message
-
DISCUSS: Hive language manual to be source control managed
Over the past few weeks I have taken several looks over documents in our
wiki.
The page that strikes me as alarmingly poor is the:
https://cwiki.apache.org/Hive/languagemanual.html

This page has several critical broken links such as
https://cwiki.apache.org/Hive/languagemanual-groupby.html
https://cwiki.apache.org/Hive/languagemanual-transform.html

The language manual used to be in decent shape. At times it had omissions
or was not clear about what version something appeared it, but it was very
usable.

A long time ago I had began and completed moving the wiki documentation
inside the project as xdoc. After completion, several had a problem with
the xdocs approach. The main complaint was the xdoc approach was too
cumbersome. (However we have basically had a 'turn over' and since that
time I am one of the few active committers)

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 do not believe all of our documentation needs to be in xdoc (as in every
udf, or every input format) but I believe the language manual surely does.

Please review the current wiki and discuss the concept of moving the
language manual to source control, or suggest other options.

Thank you,
Edward
+
Dean Wampler 2013-09-02, 12:50
+
Stephen Boesch 2013-09-01, 21:44
+
Edward Capriolo 2013-09-01, 21:47
+
Lefty Leverenz 2013-09-02, 09:06
+
Edward Capriolo 2013-09-02, 15:35
+
Lars Francke 2013-09-02, 21:05
+
Edward Capriolo 2013-09-02, 22:15
+
Alan Gates 2013-09-04, 23:37
+
Lefty Leverenz 2013-09-05, 05:38
+
Alan Gates 2013-09-06, 18:44