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

Switch to Plain View
Hive >> mail # dev >> Need to track docs for future releases

Lefty Leverenz 2013-05-02, 22:38
Copy link to this message
Re: Need to track docs for future releases
Please don't all speak at once.

Related issue:  Do we need a "Resolved" or "Fix Version/s" status for
"fixed in the wiki"?

– Lefty

On Thu, May 2, 2013 at 3:38 PM, Lefty Leverenz <[EMAIL PROTECTED]>wrote:

> Now that all the Hive docs are in the wiki, we can't commit new
> documentation to trunk or branch.  But we don't want to add docs to the
> wiki prematurely, so there's an increased likelihood that we'll lose track
> of some doc requirements for future releases.  Does anyone know of a good
> way to ensure that no doc gets left behind?
> One possibility is to use labels on JIRAs that need future documentation.
>  When HIVE-# gets committed with "Fix in 0.12" and still needs docs, it
> would get a label such as "doc-needed-v0.12" which can be used to find all
> the doc requirements at release time.
> That might be the simplest solution, although I see two problems:  if the
> fix number gets changed, the label has to change too; and sometimes people
> enter a label that seems right to them but doesn't match exactly.
> Another possibility is to use JIRAs, either adding a child JIRA for each
> closed JIRA that still needs doc or using an umbrella JIRA for each
> upcoming release.
> An ideal solution would automatically spew out a list of JIRAS that need
> docs for a given release number, either on request or when the release
> happens.  Is that technically possible?
> – Lefty