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
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 Leverenz 2013-05-07, 22:51