HowtoReport » History » Version 2

Zachary Scott, 12/23/2013 06:44 AM
import from source ./doc/contributing.rdoc

1 1 Yui NARUSE
=begin
2 1 Yui NARUSE
= HowtoReport
3 1 Yui NARUSE
4 1 Yui NARUSE
How to report bugs in Ruby
5 1 Yui NARUSE
6 2 Zachary Scott
日本語版(Japanese version): HowToReportJa.
7 1 Yui NARUSE
8 2 Zachary Scott
If you've encountered a bug in Ruby please report it to the redmine issue
9 2 Zachary Scott
tracker available at {bugs.ruby-lang.org}[http://bugs.ruby-lang.org/].  Do not
10 2 Zachary Scott
report security vulnerabilities here, please mail security@ruby-lang.org.
11 1 Yui NARUSE
12 2 Zachary Scott
There are a few simple steps you should follow in order to receive feedback
13 2 Zachary Scott
on your ticket.
14 1 Yui NARUSE
15 2 Zachary Scott
* If you haven't already,
16 2 Zachary Scott
  {sign up for an account}[https://bugs.ruby-lang.org/account/register] on the
17 2 Zachary Scott
  bug tracker.
18 2 Zachary Scott
* Try the latest version.
19 2 Zachary Scott
20 2 Zachary Scott
  If you aren't already using the latest version, try installing a newer
21 2 Zachary Scott
  stable release. See
22 2 Zachary Scott
  {Downloading Ruby}[http://www.ruby-lang.org/en/downloads/].
23 2 Zachary Scott
* Look to see if anyone already reported your issue, try
24 2 Zachary Scott
  {searching on redmine}[https://bugs.ruby-lang.org/projects/ruby-trunk/issues]
25 2 Zachary Scott
  for your problem.
26 2 Zachary Scott
* If you can't find a ticket addressing your issue,
27 2 Zachary Scott
  {create a new one}[https://bugs.ruby-lang.org/projects/ruby-trunk/issues/new].
28 2 Zachary Scott
* Choose the target version, usually current. Bugs will be first fixed in the
29 2 Zachary Scott
  current release and then {backported}[rdoc-label:label-Backport+Requests].
30 2 Zachary Scott
* Fill in the Ruby version you're using when experiencing this issue
31 2 Zachary Scott
  (<code>ruby -v</code>).
32 2 Zachary Scott
* Attach any logs or reproducible programs to provide additional information.
33 2 Zachary Scott
  Reproducible scripts should be as small as possible.
34 2 Zachary Scott
* Briefly describe your problem.  A 2-3 sentence description will help give a
35 2 Zachary Scott
  quick response.
36 2 Zachary Scott
* Pick a category, such as core for common problems, or lib for a standard
37 2 Zachary Scott
  library.
38 2 Zachary Scott
* Check the {Maintainers
39 2 Zachary Scott
  list}[https://bugs.ruby-lang.org/projects/ruby/wiki/Maintainers] and assign
40 2 Zachary Scott
  the ticket if there is an active maintainer for the library or feature.
41 2 Zachary Scott
* If the ticket doesn't have any replies after 10 days, you can send a
42 2 Zachary Scott
  reminder.
43 2 Zachary Scott
* Please reply to feedback requests. If a bug report doesn't get any feedback,
44 2 Zachary Scott
  it'll eventually get rejected.
45 2 Zachary Scott
46 2 Zachary Scott
=== Reporting to downstream distributions
47 2 Zachary Scott
48 2 Zachary Scott
You can reports downstream issues for the following distributions via their bugtracker:
49 2 Zachary Scott
50 2 Zachary Scott
* {debian}[http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=ruby-defaults]
51 2 Zachary Scott
* {freebsd}[http://www.freebsd.org/cgi/query-pr-summary.cgi?text=ruby]
52 2 Zachary Scott
* {redhat}[https://bugzilla.redhat.com/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=MODIFIED]
53 2 Zachary Scott
* {macports}[http://trac.macports.org/query?status=assigned&status=new&status=reopened&port=~ruby]
54 2 Zachary Scott
* etc (add your distribution bug tracker here)
55 2 Zachary Scott
56 2 Zachary Scott
=== Platform Maintainers
57 2 Zachary Scott
58 2 Zachary Scott
For platform specific bugs in Ruby, you can assign your ticket the current
59 2 Zachary Scott
maintainer for a specific platform.
60 2 Zachary Scott
61 2 Zachary Scott
The current active platform maintainers are as follows:
62 2 Zachary Scott
63 2 Zachary Scott
[mswin32, mswin64 (Microsoft Windows)]
64 2 Zachary Scott
  NAKAMURA Usaku (usa)
65 2 Zachary Scott
[mingw32 (Minimalist GNU for Windows)]
66 2 Zachary Scott
  Nobuyoshi Nakada (nobu)
67 2 Zachary Scott
[IA-64 (Debian GNU/Linux)]
68 2 Zachary Scott
  TAKANO Mitsuhiro (takano32)
69 2 Zachary Scott
[Symbian OS]
70 2 Zachary Scott
  Alexander Zavorine (azov)
71 2 Zachary Scott
[AIX]
72 2 Zachary Scott
  Yutaka Kanemoto (kanemoto)
73 2 Zachary Scott
[FreeBSD]
74 2 Zachary Scott
  Akinori MUSHA (knu)
75 2 Zachary Scott
[Solaris]
76 2 Zachary Scott
  Naohisa Goto (ngoto)
77 2 Zachary Scott
[RHEL, CentOS]
78 2 Zachary Scott
  KOSAKI Motohiro kosaki
79 2 Zachary Scott
[Mac OS X]
80 2 Zachary Scott
  Kenta Murata (mrkn)
81 2 Zachary Scott
[cygwin, bcc32, djgpp, wince, ...]
82 2 Zachary Scott
  none. (Maintainer WANTED)
83 1 Yui NARUSE
84 1 Yui NARUSE
=end