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

Switch to Plain View
Hive >> mail # dev >> Documentation Policy


+
Lars Francke 2013-11-05, 08:16
Copy link to this message
-
Re: Documentation Policy
I think opening a separate doc ticket and making it a subtask of the dev
ticket works pretty well.  The subtask can contain notes specific to
documentation.

Eugene

On Tue, Nov 5, 2013 at 12:16 AM, Lars Francke <[EMAIL PROTECTED]>wrote:

> Hi,
>
> I wanted to ask how people feel about a policy where an issue is not
> closed until documentation has been added to the Wiki?
>
> Problematic issues fall roughly in two categories:
> * They have a generic title (add UDF for XY) an attached patch and a
> few code reviews without ever even mentioning what the name or usage
> of the new UDF is (<https://issues.apache.org/jira/browse/HIVE-5252>)
>
> * They have a design document or description with the intended syntax
> but that's often not the final form so one has to look up the patch
> (can't find a good example right now)
>
> Both are a lot of work to document for someone who has not followed
> that issue. Tracking undocumented things would be got to not forget
> about it and to have an incentive to do it.
>
> Obviously not all things need documentation, and not all things need
> to be documented by the person who submitted the patch. But to make
> things easier for documentation people it'd be great if the issue
> could contain an up to date description of at least the syntax changes
> and configuration options etc. so that we can tidy it up and transfer
> it to the wiki. It's not nice to dig through patches for this.
>
> Another alternative would be to open issues like "Document HIVE-5252"
> but I like the other option better.
>
> What do people think?
>
> Cheers,
> Lars
>

--
CONFIDENTIALITY NOTICE
NOTICE: This message is intended for the use of the individual or entity to
which it is addressed and may contain information that is confidential,
privileged and exempt from disclosure under applicable law. If the reader
of this message is not the intended recipient, you are hereby notified that
any printing, copying, dissemination, distribution, disclosure or
forwarding of this communication is strictly prohibited. If you have
received this communication in error, please contact the sender immediately
and delete it from your system. Thank You.
+
Thejas Nair 2013-11-05, 19:40
+
Lefty Leverenz 2013-11-06, 08:20
+
Eugene Koifman 2013-11-06, 17:17
+
Thejas Nair 2013-11-06, 20:07
+
Lefty Leverenz 2013-11-06, 20:48
+
Thejas Nair 2013-11-06, 21:44
+
Lefty Leverenz 2013-11-10, 07:59
+
Lefty Leverenz 2014-06-10, 09:46