We use the "Buddy System" for filing issues.
Before filing a new issue, please:
Re-read the documentation
(especially the FAQ and the
online Subversion book).
Search the issue tracker:
Find someone else who agrees this is a bug.
Post to the users@subversion.tigris.org mailing list (or to
dev@subversion.tigris.org if you're already pretty sure
it's a bug), or chat in IRC, regarding the bug or feature request you were about to
file. People there will ask you questions, try to reproduce the
problem, advise you if there's any past history of similar
problems, and in general help you decide whether a new issue is
warranted. If it is, they can also help you get the bug report
into a useful form. See here for how to
write a useful bug report.
If you do file an issue, remember to include a link to the mailing list message(s) or IRC conversation where you discussed the problem. Not only does this provide important context for anyone reading the issue, it also confirms that the issue has passed the basic buddy test: you found someone else who agrees it's a problem. Issues that haven't been through the "buddy system" may be summarily closed. We're sorry to do this, but statistically, most unbuddied filings turn out to be bogus, and the issue tracker is not a convenient place to separate the good reports from the bad.
We depend on the mailing list and IRC channel as a first level of filtering for our bug tracker. Without this filtering, the tracker would be full of duplicate issues, non-issues, and unreproducible issues. Please help us keep the bug database clean, by always finding a buddy before you file!
When mailing the list with a concern, make sure that your e-mail describes your bug or enhancement fully. Provide details about the versions of the relevant software (Subversion, Apache, neon, etc.) that you are using, about your operating system, and about any other thing that might seem pertinent to the issue. If you can provide a script which consistently reproduces a problem, that can be incredibly helpful to those evaluating and/or working on your issue.
You must be logged in to the web site to add a new issue, or to comment on existing issues. To modify existing issues beyond simply leaving a comment — e.g., to change fields or status — you must be both logged in and have the Observer role in the Subversion project; this is true even for issues that you created yourself.
Here's how to acquire the Observer role:
When an issue is first filed, it automatically goes in the "---" target milestone, which indicates that the issue has not yet been processed. A developer will examine it and maybe talk to other developers, then estimate the bug's severity, the effort required to fix it, and schedule it in a numbered milestone, for example 1.1. (Or they may put it the unscheduled or nonblocking milestone, if they consider it tolerable for all currently planned releases.)
An issue filed in unscheduled might still get fixed soon, if some committer decides they want it done. Putting it in unscheduled merely means it hasn't been scheduled for any particular release yet. The nonblocking milestone, on the other hand, means that we do not anticipate ever scheduling the issue for a particular release. This also does not mean the issue will never be fixed; it merely means that we don't plan to block any release on it.
Severity is represented in the Priority field. Here is how priority numbers map to severity:
Effort Required is represented in the Status Whiteboard with an "e number", which is the average of the most optimistic and most pessimistic projections for number of engineer/days needed to fix the bug. The e number always comes first, so we can sort on the field, but we include the actual spread after it, so we know when we're dealing with a wide range. For example "e2.5 (2 / 3)" is not quite the same as "e2.5 (1 / 4)"!
And so, with further ado, we give you (drumroll…) the Subversion Issue Tracker.
Again, remember that to add or modify issues, you must be logged into the website.