Handling documentation bugs

= Fixing fedora-docs Bugs in Bugzilla =

Resolution
Current prevailing wisdom is that resolving bugs in Bugzilla for the Fedora Documentation product should work something like this.


 * CURRENTRELEASE - Use this resolution for fixes to a document that is to be released soon, frequently, or continuously (such as one of the common entities files).
 * ERRATA - Use this resolution for fixes to a document for which errata are released (e.g. Release Notes).
 * NEXTRELEASE - Use this resolution for fixes to a document that is targeted for a specific software release (e.g. Fedora Core X Installation Guide).
 * NOTABUG - Probably not used often; stylistic differences on which there is no guidance. Always make a comment if you use this resolution, so as not to offend the reporter.
 * WONTFIX - Use for legacy or otherwise unmaintained documents; always make a comment if you use this resolution, so as not to offend the reporter.
 * RAWHIDE - Use for a fix that is committed to CVS for a new or unreleased document. (Generally, this resolution will only be for FDP members to file bugs against CVS docs.  If the fix is for a document that has already been published, wait to close the bug until the new version is re-published on the web, and then close as CURRENTRELEASE.

Some resolutions are not appropriate for FDP use:


 * WORKSFORME - Unlike programs, a document can simultaneously work and not work for different readers in the exact same environment. If a document is confusing, it should be changed. Otherwise, use NOTABUG.
 * UPSTREAM - The FDP is the source for all official Fedora Documentation.

More to come...