[
https://issues.apache.org/jira/browse/HIVE-2085?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13013021#comment-13013021
]
Edward Capriolo commented on HIVE-2085:
---------------------------------------
Lars
I understand that no one likes to see issues closed as "WONT FIX" (I am not
trying to be snotty). Hive currently has hundreds of Open Issues. Opening an
issue like "Document X" is vague. You are correct in saying this is an issue
tracker, but it is quite common to first come on the IRC or ML and discuss the
feature you want.
IMHO. What this boils down to is if the developers had more time to document
they would. If we had to open an issue for each thing that needed more
documentation Jira would be unusable (Many things need documentation).
Generally, if the user submitting the request is not willing to assign it to
themselves there is little chance of it getting done by anyone else (as
evidenced by the number of opened unassigned tickets). These issues should be
actionable in the near term. If no one is going to actively work on the issue
we do not get anything from having a ticket open on it.
> Document GenericUD(A|T)F
> ------------------------
>
> Key: HIVE-2085
> URL: https://issues.apache.org/jira/browse/HIVE-2085
> Project: Hive
> Issue Type: Improvement
> Components: Documentation
> Reporter: Lars Francke
> Priority: Minor
>
> GenericUDFs are very poorly documented, this includes everything they relate
> to:
> * ObjectInspector (JavaDoc not really helpful for someone not familiar with
> Hive)
> * ObjectInspectorFactory
> * ObjectInspectorConverters
> * ...
> An example would help as well as a unit test for one of the built in
> GenericUDFs. Writing a normal UDF is pretty well documented but GenericUDFs
> (and UDTF/UDAF) require more knowledge about the inner workings of Hive and
> that could be documented better.
--
This message is automatically generated by JIRA.
For more information on JIRA, see: http://www.atlassian.com/software/jira
