Red Hat Bugzilla – Bug 876015
RFE: implement Docs Contact field and controls
Last modified: 2014-10-12 18:49:27 EDT
Description of problem: very similar to QA, Content Services requires a way to assign bugs to writers. Currently this need is partially served by the Errata Tool's Docs Queue, which is able to assign writers to specific errata, which are comprised of one or more (or many) bugs. ECS is now at the point where we require a more fine-grained way to associate engineering bugs and features with individual writers, or collectively to a general mailing list. Reasons include, among others:
* some products, most notably in middleware, do not go through the Errata Tool, and thus we currently have no mechanism for assigning those bugs to writers outside of manual tracking, which is tedious and error-prone.
* it would be highly useful to be able to assign specific bugs to authors for the purposes of scoping bugs and features for guide documentation.
* Release Notes and known issues (among other documentation types, such as Technology Previews) should be assigned to individual writers outside of the Docs Queue, for dispensation and tracking purposes.
Version-Release number of selected component (if applicable): version 4.2.3-4.1
Actual results: there is currently no field in which we can assign a bug to a Content Services representative like a developer can be assigned to a bug using the Assigned To field, or like QA is able to assign a Quality Engineer using the QA Contact field.
Expected results: ECS is requesting the implementation of a Docs Contact field in Bugzilla that mirrors the QA contact field and associated controls. Specifically:
* the Docs Contact email address should be displayed along with the (edit) and (take) controls.
* the Docs Contact should default to a generic mailing list that we will specify.
* the "Reset Docs Contact to default for component" check box should exist, just like it does for QA Contact.
* it would make sense to list the Docs Contact controls immediately after the Assigned To and QA Contact fields on the left-hand side.
* Docs Contact should be able to be fully manipulated (query, set and reset) by the XML-RPC (or other, such as JSON) interfaces.
* the Errata Tool's Documentation Work Queue should exist separately from the Docs Contact field. Assigning an author to an erratum, which lists one or more Bugzillas, does not have any effect on the Docs Contact of any of those Bugzillas, i.e. the ET does not need to set Docs Contact.
* likewise, changes to the Doc Type or Doc Text field do not have any effect on the Docs Contact field.
Additional info: none at present.
Spoke to Douglas about this. Two points:
1) Like qa contact, this can be optional (as opposed to assignee which is mandatory)
2) We will be having a default docs contact for all components, just like we do with assignee and qa.
Hopefully this will just be a case of copying and pasting the qa contact code all over the place.
Verify version 4.4-1 on test server --> PASS
1. Login bugzilla with admin account.
2. Create a product test with component componentA and componentB.
3. Set componentA's default Docs Contact is firstname.lastname@example.org and componentB's default Docs Contact is email@example.com.
4. Login bugzilla with firstname.lastname@example.org.
5. Create a test product bug bugA with componentA.
6. Create another test product bug bugB with componentB.
7. Go to bugA's detail page, check Docs Contact field.
8. Go to bugB's detail page, check Docs Contact field.
9. Go to bugB's detail page, click edit link of Docs Contact field, input email@example.com in the textbox, then submit.
10. Go to bugB's detail page, click take link of Docs Contact field then submit.
11. Go to bugB's detail page, click edit or take link of Docs Contact field, hook "Reset Docs Contact to default for component", then submit.
12. Click search link at top menu of the page.
13. In advance search page, click search by people, hook "the Docs Contact", select contains in drop-down list, and input firstname.lastname@example.org, then click search button at bottom.
14. Click search link at top menu of the page. In advance search page, click Custom Search, set "Doc contact" -> "Contains the string" -> "email@example.com", then click search button at bottom
1. After step 7, Docs Contact field: firstname.lastname@example.org
2. After step 8, Docs Contact field: email@example.com.
3. After step 9, Docs Contact field: firstname.lastname@example.org.
4. After step 10, Docs Contact field: email@example.com.
5. After step 11, Docs Contact field: firstname.lastname@example.org.
6. After step 13, bug B will be searched out.
7. After step 14, bug B will be searched out.