-Re: Need to track docs for future releases
Lefty Leverenz 2013-05-07, 22:51
Please don't all speak at once.
Related issue: Do we need a "Resolved" or "Fix Version/s" status for
"fixed in the wiki"?
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