[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

Re: BugZappers wiki cleanup - comments and questions



Thanks for all your hard work to make these pages cleaner. I am a little concerned that you are moving very quickly and in some cases making some drastic changes :) I do appreciate that you are keeping us updated here.

It is often a good idea when making large changes like this to create your own draft and so the group can look at it first.

It may not look like it but what we have was a result of a lot of rework and discussion a year ago of what using material from the years before the current group got involved with triage. What this means is that in some cases we should probably take a big step back rewrite some of the pages from scratch instead of continuing to roll the content forward, merge it into different pages, etc.... which is what we did a year ago :)

What might help most is to create a site map of sorts and do a layout design so we have a larger view of

Christopher Beland wrote:
1.) In an effort to start cleanup, I merged
[[BugZappers/GettingStarted]] into [[BugZappers/Joining]] and cleaned
up links from the front page.  [[BugZappers/HelpWanted]] should also
be trimmed and merged in there.

I also renamed [[BugZappers/TakingAction]] to [[BugZappers/How to
Triage]], so it has a clearer purpose.


2.) The subpages under [[BugZappers/HouseKeeping#Task_Breakdown]]
should probably be merged into the master page.

I disagree. The main page was too big and was intentionally broken down this way. Breaking the tasks up makes it easier to maintain. Having spent a week reworking this section I'd be sad to see it all reverted unless other people think it would work better a different way.


3.) [[BugZappers/components]] and [[BugZappers/FindingBugs]] are both
serving the dual purpose of tracking what needs to be worked on and
providing links to BugZilla to find bugs that need work.  Any
objections to merging to [[BugZappers/Tracking]]?

Yes, but your redirect of Goals-->Components didn't help make things any cleaner. This is why we need to discuss and coordinate some of these changes :)


4.) [[BugZappers/Joining]] and [[BugZappers/ActiveTriagers]] have
somewhat contradictory advice:

  "This does mean certain components are reserved. If you are
  unfamiliar with a component and someone is very active there, it is
  probably a good idea to pick a different component."

vs.

 "It is okay for more than one person to cover the same component"

We need to have clearer advice.

Let's discuss at our meeting on Tuesday

I also see that [[BugZappers/Special Procedures]] has a note arguing
that special opt-outs for certain developers are not scalable

Yes, those comments were mine.  I think this page should should go away.

I think it would actually be a good idea if we took the list at
[[BugZappers/components]] and merged in the list of people who are
working on a particular component.  (Adding a second list for non
"key" components if people are claiming those.)  The clearest
indication for new triagers would be to add a column to indicate for
each column whether or not more help is wanted for that component
("Yes") or if the existing triagers or developers think they have it
covered ("No").  But there are other ways to present this information.


5.) As for the other content on [[BugZappers/Special Procedures]],
[[BugZappers/How to Triage]] is the main instruction page, but we also
have [[BugZappers/BugStatusWorkFlow]] and lots of advice on
[[BugsAndFeatureRequests]] (which is oriented toward bug filers, not
bug triagers).

Clearly we need the One True List of Things Every Bug Should Have,
which filers should supply and triagers will request if they don't.
(This varies by component, and type of bug - e.g. crashes
vs. misspellings vs. feature requests.)  The ASSIGNED section of
[[BugZappers/BugStatusWorkFlow]] has some of that info, which can be
removed and replaced with a link to the canonical place.
BugStatusWorkFlow can then just be an explanation of Bugzilla states.

[[BugZappers/How to Triage]] and [[BugsAndFeatureRequests]] then need
to be harmonized and streamlined.  This is the crux of the problem of
making a minimal set of instructions that bug filers and triagers
can actually follow.

Yes, as long as we have two separate pages as they are two different tasks.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]