Processes for using bugzilla and procedures for assigning and interacting with bugs should be documented. Currently the only such documentation that exists are the bug writing guidelines, which are helpful but only to a certain extent.
Hi, We have a wiki page (https://wiki.yoctoproject.org/wiki/Bugzilla_Configuration_and_Bug_Tracking) that describes the Yocto implementation of Bugzilla. I can get some pointers into this page in the mainstream YP documentation. I don't believe we should repeat this information in the YP doc set. Scott
Thanks, Scott. Stephen and I had a conversation about whether this documentation existed (and if so was up-to-date), and he was going to take the AR to check into this. Glad to hear it does exist, and pointers to it from other places would be useful since the wiki can be hard to find things in. I've run into a lot of out of date stuff on the wiki so it would be valuable to make sure all the information here is still correct and complete.
Hi Amber, I agree... the wiki has been historically out of date badly in spots. I am glad someone is looking at this for "up-to-dateness". I will ACCEPT the bug and be sure to get adequate pointers in from relevant areas of the mainstream YP doc set that will guide the user to that page. Scott
Scott, One of the items Amber is concerned about is the weekly Bugzilla cleanup request I send out. I have pasted an example below. Not sure if this is clear enough and if I need to change it I will. "All, No Estimate: You are an owner of a medium or higher priority bug or enhancement in bugzilla targeting completion during YP 2.5. Do to the amount of work we are trying to get done in Yocto Project; we are asking you take a minute or two and give an estimated amount of work – in ""Perfect-Work-Days"" – to complete the bug/enhancement. We know your estimates might not be perfect themselves; but this effort will help us know who is overloaded and where to apply the resources we are adding to the project. Please estimate how many ""Perfect-Work-Days"" remain to close the bugs in the ""Estimate: Person-Days"" box in Bugzilla. Currently 556 of the 556 open YP 2.5 bugs/enhancements have an estimate time entered. Also while updating the bug/enhancement please insure you have it targeting the correct Milestone for completion. Please review the below links to find these bugs: High Bugs: https://wiki.yoctoproject.org/wiki/Bug_Triage#High_Enhancements.2FBugs Medium+ Bugs and Enhancements by Owner: https://wiki.yoctoproject.org/wiki/Bug_Triage#Medium.2B_Bugs_and_Enhancements_by_Owner_.21.28Future.2C_2.4.29 Medium Bugs and Enhancements by Owner: https://wiki.yoctoproject.org/wiki/Bug_Triage#Medium_Bugs_and_Enhancements_by_Owner_.21.28Future.2C_2.4.29 And/Or: Old Milestone: You are assigned an open bug in the Yocto Project Bugzilla tracker which has an old milestone assigned to it. To see the list of bugs with old milestones please look here: https://wiki.yoctoproject.org/wiki/Bug_Triage#Old_Milestone. Since the milestone for this bug in the Yocto Project has been completed please do one of the below actions. 1. Close the bug since it has been completed. (Great News!) 2. If it is partly done: break the bug request into two or more parts and close what is done and move the remaining parts to a future milestone. 3. If it is not done at all; but you still plan to fix it in the future; move the bug to milestone which is not yet completed. (Future is a possible milestone.) 4. If it is no longer your plans to do this, but you think this still needs to be fixed – change the bug to an unassigned priority, we will triage it again and reassign it someone. 5. If it no longer makes sense to fix this bug, please close the bug request as OBSOLETE or WONTFIX. And/Or: Needs specific milestone: You are assigned an open bug or enhancement in the Yocto Project Bugzilla tracker which has a medium+ or high priority assigned to it without a targeted specific milestone or specific dot release. All open medium+ or high bugs must have a specific target milestone or specific dot release assigned to them (i.e. 2.2.3). High Bugs: https://wiki.yoctoproject.org/wiki/Bug_Triage#High_Enhancements.2FBugs Medium+ Bugs and Enhancements by Owner: https://wiki.yoctoproject.org/wiki/Bug_Triage#Medium.2B_Bugs_and_Enhancements_by_Owner_.21.28Future.2C_2.4.29 Note: M+ and High are not allowed to be set to the Future milestone either. And/Or: Needs to be broken up: You are assigned an open bug or enhancement in the Yocto Project Bugzilla tracker which is a medium or higher priority and has more than 5 ""Perfect-Work-Days"" assigned. All open medium or higher bugs with more than 5 days should be broken into smaller dependent tasks. Please review the below links to find these bugs: High Bugs: https://wiki.yoctoproject.org/wiki/Bug_Triage#High_Enhancements.2FBugs Medium+ Bugs and Enhancements by Owner: https://wiki.yoctoproject.org/wiki/Bug_Triage#Medium.2B_Bugs_and_Enhancements_by_Owner_.21.28Future.2C_2.4.29 Medium Bugs and Enhancements by Owner: https://wiki.yoctoproject.org/wiki/Bug_Triage#Medium_Bugs_and_Enhancements_by_Owner_.21.28Future.2C_2.4.29 And/or: Dependency Issue: You have a dependency problem in bugzilla. This means that either your bug or enhancement is dependent on a lower priority bug or enhancement, or your bug or enhancement has a target milestone earlier than dependent bugs or enhancements. Please open your bug and review the dependencies to see what the problem is with it. And/or: Need Info > 2 Weeks: You all have bugs or requested enhancements for Yocto Project for which more information has been requested about to allow progress on these bugs. These bugs or enhancements have been in this state, waiting for this information from you, for at least 2 weeks. Please update the bug or enhancement request at: https://wiki.yoctoproject.org/wiki/Bug_Triage#NEEDINFO to have the requested information so that work on this bug or enhancement can move forward. If you can’t supply the information please change the status to CLOSED and the resolution to either OBSOLETE or WONTFIX whichever is more appropriate. See the list of the specific bugs and the issues with them in the below table:"
Hello Stephen, In reference to Comment 4 - are you wondering if that text needs to be rewritten when you send the bug status email out? Because it is not in the wiki. We are going to put in some references to the wiki, but we don't know exactly what you are asking for in Comment 4. Thanks! Kristi
I would say Amber might be better at answering these questions. Her request was to have what i am requesting each week, added to the bug writing guidelines. I would suggest what I added in comment 4 be mapped to the guideline and if any of it is missing from the guidelines it be added. But, Amber would know better what she felt was missing.
As long as the information in comment 4 is correct I believe it should just be added to the wiki, rather than dispersed simply in email format.
In fact, it might be better if I can refer in the e-mail to sections in the wiki that document the guidelines in comment 4.
Amber and Stephen, The following sections reference the Bugzilla wiki page and two links reference the dev-manual "Submitting a Defect Against the Yocto Project" (http://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#submitting-a-defect-against-the-yocto-project) http://www.yoctoproject.org/docs/2.5/ref-manual/ref-manual.html#detailed-supported-distros http://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#dev-other-debugging-others (end of section) http://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#submitting-a-defect-against-the-yocto-project Please check these out and if they are okay from a documentation standpoint, I will step away from the bug and I will reassign it to add the new information to the wiki page. If further documentation changes are necessary please let me know. Thank you!
So do I understand this correctly that Comment 4 is going to be added to the wiki page? I think we have adequate pointers from the YP doc set into the Bugzilla wiki page. We can assist in the review of any text introduced into the wiki page if you like. Scott
Scott, Yes, I would like comment 4 to be reworded/improved and added to the wiki. If you can give me pointer/links to what you have to be reviewed I would like to review it also.
Stephen, We don't have anything that needs reviewed in the YP docs. We have the appropriate amount of links from related areas into the Bugzilla wiki. Would you like me to edit that wiki page and incorporate the information in the Comment 4? I believe I have access to do that. That would probably be more efficient than providing editorial comments to new material in the wiki. Scott
Scott, That sounds like a good plan. Please send me a link when you have done your pass and I will review. Thanks, Stephen
Hi, See https://wiki.yoctoproject.org/wiki/Bugzilla_Configuration_and_Bug_Tracking#Bug_Owner for the enhanced "Tracking" section that includes the general information from Comment 4. Note that I wrote this so that it is general and does not include release-specific information and links that were cut and pasted into the comment as the example. Look it over and see if this is okay. We can iterate on the information if needed. Thanks, Scott
I tweaked the information slightly to make it more current. It looks good.
Thanks Stephen, I set the doc flag to "done" to get it off the radar. Scott