I opened this issue to begin a discussion about how to use the new issue tracker. We have also experienced the other one(Google code) and would be worthy to think how use it in compared with that.
-
Something in Github Issues differ from one hosted on Google code(like everything is handled using labels and of course, fields like |Status| should be handled using those if we don't want just use the built-in status, since there is only two of them, Open and Close)
-
As I could see Honza has started posting issues (Interesting!), there should be some labels to start with.
- Absence of defining a template for different issues
- How to use Milestones
- Any missing?
I think the first and third could be solved by the idea which @cadorn has to integrate the Issues some where. Using this idea, we could use labels in the way we interested in.
Note: I follow the style of built-in labels name(like no hyphen(-) as a separator in labels name and start in lower case) for the the list below. I think underscore is a better case, as some words have hyphen grammatically(like auto-completion e.g.), your thought?
List of labels look necessary(Imported from the Google code):
debugger
, ui
, command line
, script
, css
, html
, shortcuts
, editors
, profiler
, quick info
,search
, watch
, breakpoint
, console
, cookie
, doc
, computed
, events
, layout
, dom
, inspector
, auto-completion
test case needed
, test case available
, unit test wanted
, unit test available
, localization
, platform
.
Note: There is some labels above that wasn't in the Google code like unit test available
, unit test wanted
, as I think we are going to use the the framework provided by the SDK instead of FBTest.
Also the names keys
, inspect
, locale
are changed to shortcuts
, inspector
, localization
.
What do you think?
Some suggestion to create some ones which would be helpful like:
needs discussion
search to select issues need to be discussed on the weekly meeting. We also should question
label (a predefined label) for the issue needs discussion on the page(no need to be discussed in the meeting and could be solved by discussing on the issue page)
docs needed
wiki needed
OR wiki update needed
should be stated in wiki or affect any existence wiki . Would be also helpful when needing to update wikis for a new release.
api relevance
=> when an api is changed or deprecated.
performance
=> Issue affect performance.
causes bug
=> a patch for this issue causes another bug addressed by another issue.
bug source
=> mark an issue with this label, if there is another issue caused this bug.
Your thought?
Github Issues has a feature called Milestones that is to make sure everyone/everything is working towards a goal and could start grouping issues that needs to be done to get the goal. What do you think about using it with Firebug.next, as we don't used to use something like this? Use this just when an issue blocks the next release?
Farshid