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
