400677 - Documentation about products is mostly non-existent

Status: RESOLVED FIXED

(Bugzilla :: Documentation, defect)

Description

[Frédéric Buclin]

The current documentation says:

"Don't worry about the "Closed for bug entry", "Maximum Votes per person", "Maximum votes a person can put on a single bug", "Number of votes a bug in this Product needs to automatically get out of the UNCONFIRMED state", and "Version" options yet. We'll cover those in a few moments."

Wow, so useful!

Comment 1

[Sam Folk-Williams]

I'm adding a bunch of stuff to this section in bug 397665. The patch in there is still under review. That bit has not been taken out in my patch (yet). I assumed when reading that bit that indeed we did cover those "in a few moments", but i'm now thinking they never do get covered. So, when the other bug get's approved I'd like to take out this paragraph and add documentation for these items.

Comment 2

[Sam Folk-Williams]

Attachment: draft 1

added a description of all the product fields. also added xref's to some sections for more detail (needed also to add "xreflabel" bits to other sections). Also found some existing spelling errors.

Comment 3

[Frédéric Buclin]

Comment on attachment 298038 [details] [diff] [review]
draft 1

>     <glossterm linkend="gloss-product" baseform="product">
>-    Products</glossterm>

Unrelated to this patch: did you note that this link doesn't work? The glossary has no anchor for "product".

r=LpSolit

Comment 4

[Frédéric Buclin]

Colin, reopen if you want to see this doc patch in 2.20 and 2.22 too (it doesn't apply cleanly and would need to be backported).

tip:

Checking in docs/xml/administration.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/administration.xml,v  <--  administration.xml
new revision: 1.81; previous revision: 1.80
done

3.0.3:

Checking in docs/xml/administration.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/administration.xml,v  <--  administration.xml
new revision: 1.70.2.8; previous revision: 1.70.2.7
done