Re: Documenting API's for the 1.0.0 release

2015-01-13 Thread Brock Noland
javadocs + java annotations But I think we'll need a page on the wiki covering this and describing our policies including the discussion of the thrift layer which we won't be able to doc via annotations or javadocs as it's generate code. On Tue, Jan 13, 2015 at 3:20 PM, Thejas Nair wrote: > IMO

Re: Documenting API's for the 1.0.0 release

2015-01-13 Thread Thejas Nair
IMO, this would be javadocs. That should be the primary source of truth for this information. We can additionally capture this in wikidocs as well. On Tue, Jan 13, 2015 at 3:08 PM, Lefty Leverenz wrote: > Thanks Brock. Is this for javadocs or wikidocs, or both? > > -- Lefty > > On Tue, Jan 13,

Re: Documenting API's for the 1.0.0 release

2015-01-13 Thread Lefty Leverenz
Thanks Brock. Is this for javadocs or wikidocs, or both? -- Lefty On Tue, Jan 13, 2015 at 12:47 PM, Brock Noland wrote: > Hi, > > As discussed at our last meetup, we should really document our public APIs. > Many had requested this be completed before Hive 1.0.0. > > As such I have created an

Documenting API's for the 1.0.0 release

2015-01-13 Thread Brock Noland
Hi, As discussed at our last meetup, we should really document our public APIs. Many had requested this be completed before Hive 1.0.0. As such I have created an uber jira to track this https://issues.apache.org/jira/browse/HIVE-9362 and created two sample sub-tasks for how I imagine this will pl