Missing documentation about keywords

RESOLVED FIXED in Bugzilla 2.20

Status

()

--
enhancement
RESOLVED FIXED
11 years ago
11 years ago

People

(Reporter: LpSolit, Assigned: sam.folkwilliams)

Tracking

2.20.5
Bugzilla 2.20

Details

Attachments

(1 attachment)

(Reporter)

Description

11 years ago
No documentation can be found about administering keywords. We should explain how they work, if they are per-product or global (currently global), if you can mark a keyword as old to prevent new entries (this is not yet implemented, but if we don't tell it, an admin cannot guess), etc...
(Assignee)

Comment 1

11 years ago
Do you have an idea where this should go?

Right now there is a very brief description here:
http://www.bugzilla.org/docs/tip/html/bug_page.html

Should we just expand that with more details or actually make a new section, say after the Flags section in Chapter 5?
Assignee: documentation → sam.folkwilliams
(Reporter)

Comment 2

11 years ago
The link you are pointing to in comment 1 is about using keywords in bugs, not about administering them. I don't say the explanation is great, but other fields are not better. That's something to fix in a separate bug.

I want this bug to focus on the administration of keywords and a section should be added at http://www.bugzilla.org/docs/tip/html/administration.html right after section 3.8 Flags. So we should have 3.9 Keywords, moving Custom fields to 3.10.
(Assignee)

Comment 3

11 years ago
Created attachment 298013 [details] [diff] [review]
first draft

OK attaching first draft - note I included an xref to a new section in a patch on bug 45207. Until/Unless that patch gets committed, this wont compile right. Let me know if we should just drop it.
Attachment #298013 - Flags: review?(documentation)
(Assignee)

Updated

11 years ago
Status: NEW → ASSIGNED

Comment 4

11 years ago
Comment on attachment 298013 [details] [diff] [review]
first draft

r=me
Attachment #298013 - Flags: review?(documentation) → review+
(Reporter)

Comment 5

11 years ago
tip:

Checking in docs/xml/administration.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/administration.xml,v  <--  administration.xml
new revision: 1.80; previous revision: 1.79
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.7; previous revision: 1.70.2.6
done
Status: ASSIGNED → RESOLVED
Last Resolved: 11 years ago
Resolution: --- → FIXED
(Reporter)

Comment 6

11 years ago
2.22.3:

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

2.20.5:

Checking in docs/xml/administration.xml;
/cvsroot/mozilla/webtools/bugzilla/docs/xml/administration.xml,v  <--  administration.xml
new revision: 1.50.2.15; previous revision: 1.50.2.14
done
Target Milestone: Bugzilla 3.0 → Bugzilla 2.20
Version: 3.1.2 → 2.20.5
You need to log in before you can comment on or make changes to this bug.