[
https://issues.apache.org/jira/browse/HIVE-2085?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13013026#comment-13013026
]
Lars Francke commented on HIVE-2085:
------------------------------------
I tried to add details about what and why should be documented so I had hoped
it wouldn't be vague. Let me know what needs clarifying and I'll gladly do it.
I've been on IRC and the mailing list and we've asked questions about these
things and tried to figure it out on our own that's why I decided to open the
ticket.
I didn't assign the issue to myself because I don't feel like I have any idea
about what's going on there. And I also don't agree on the value of open and
unassigned tickets. It gives an overview of what needs to be done still and
perhaps one of these days someone's going to focus on documentation and I think
it would be helpful then to know what's missing.
But I'll leave this issue alone now to not take any more time. Thanks for
looking at it anyway. One of your GenericUDFs can be found on Google and that's
about the only documentation/example I could find so you've already helped :)
> 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
