blog: Move Python article out of the way for now.
[gnupg-doc.git] / misc / bugs.gnupg.org / index.html
1 <!doctype html public "-//W3C//DTD HTML 4.0 Transitional//EN">
2 <html>
3 <head><title>g10 Code's bug tracker</title>
4 <link rev="made" href="mailto:webmaster@g10code.de">
5 </head>
6 <body bgcolor="#ffffff" text="#000000" link="#1f00ff" alink="#ff0000" vlink="#9900dd">
7 <div align="left">
8 <img src="pagehead.png"
9      alt="[g10 Code Logo]" width="1065" height="100">
10 </div>
11
12
13 <h1><a name="intro">Bug tracker for GnuPG and related projects</a></h1>
14
15 <p>
16
17
18 <ul>
19  <li>Goto to the list of <a
20 href="https://bugs.gnupg.org/gnupg/issue?%40sort=id&%40sortdir=on&%40group=category&%40columns=id%2Cactivity%2Ctitle%2Ccreator%2Cassignedto%2Cstatus&%40filter=status&status=-1%2C1%2C2%2C3%2C4%2C5%2C6%2C7&%40pagesize=50&%40startwith=0"
21 >GnuPG related bugs</a>.
22 </ul>
23
24
25 <h2>Becoming a registered user</h2>
26 <p>
27 To enter a bug into our bug tracker you need to be a registered user.
28 A registered user will be assigned a <em>provisional user role</em>
29 which allows to enter new bugs and to edit these bugs.  The <em>user
30 role</em> will be granted by an administrator on demand.  Just add
31 remark to your bug report that you wish to work more with the bug
32 tracker.  We have these strict rules to avoid spam and keep trolls
33 away from the tracker.
34 <p>
35 Note that some actions (e.g. closing a bug) are even restricted from
36 regular users.  A developer account is required for these actions.
37 The rationale is that only a developer will be able to fix things and
38 thus decides whether a bug is to be closed.  A bug may be re-opened at
39 any time.
40
41
42 <h2>How to add a new bug</h2>
43 <p>
44 Please note that this bug tracker is a public resource and everything
45 you enter there will be available for the whole networked world.  It
46 is similar to a public mailing list and there is no easy way to
47 retract any information.
48 <p>
49 You should follow these steps to enter a new bug (issue):
50 <p>
51 <ul>
52  <li>Review the documentation and the mailing list archives to see
53      whether your problem has already been addressed.  Often bugs are
54      mere configuration problems.
55      <p>
56  <li>Check that the bug has not yet been entered and that there is no
57      similar bug in the tracker.  Use the search option for this.  It
58      is best to also look through the already closed
59      (<em>resolved</em>) issue.
60      <p>
61
62  <li>If you consider the bug a severe security problem and you do not
63      want to publish it, please write to security at gnupg.org to ask
64      for advice and our encryption keys.  See also the AUTHORS file in
65      each package.
66      <p>
67
68  <li>Select the <em>Create New</em> menu entry.  An empty page will be
69      presented.
70      <p>
71
72  <li>Come up with a meaningful short description of the bug and enter
73      this into the <em>title</em> field.
74      <p>
75
76  <li>Assign a priority for the bug. These priorities are
77      defined:
78      <p>
79      <dl>
80        <dt>bug<dd>Use this for a regular bug.
81        <dt>urgent<dd>Use this if you believe that the problem should
82        be fixed soon.
83        <dt>critical<dd>Use this if your problem is really severe and inhibits
84        you from working with the software.  Do not use it if you can
85        find a workaround for the problem.
86        <dt>minor-bug<dd>Use this for a minor bug
87        <dt>feature<dd>Use this for a technical feature requests.
88        <dt>wish<dd>Use this for everything else, for example to
89        request better documentation or a new FAQ entry.
90      </dl>
91      <p>
92
93  <li>See whether you can assign category to the bug. There is a drop
94      down list with all available categories.  A category is in
95      general the name of the application with the bug, but might also
96      be a library.  If you can't figure out the category, keep it at
97      <em>- no selection -</em>.  The <em>dirmngr</em> category is only
98      used for the old standalone package; since GnuPG 2.1 dirmngr
99      is part of GnuPG proper; thus use <em>gnupg</em> as category and
100      add <em>dirmngr</em> to the topic field.
101      <p>
102
103  <li>Now for the most important field: The description of the problem.
104      You enter this information into the <em>Change Note</em> field.
105      Please take care to use hard line breaks and format the report
106      as you would do by mail.  No HTML please.
107      <p>
108      Make sure that you describe the bug as good as possible and try
109      to come up with a minimal recipe on how to replicate the bug. We
110      need to know <strong>the version of the software</strong> and if
111      you are using a non-released version the GIT commit id.  The type
112      and version of your operating system is usually important, so
113      please tell us.  In particular tell us if you are problem occurs
114      on a non Unix system, i.e. MS Windows.
115      <p>
116
117  <li>If you need to enter more information, you may upload any kind of
118      file.  However, please do this only if you are sure that these
119      information are important and that they do not contain
120      confidential data.  This file will be public and it won't be
121      possible to retract it anymore.  Avoid screen shots unless you
122      are asked for them.
123      <p>
124      The problem with screen shots or, worse, screen casts is that we
125      would need to transcript them to text for evaluating the problem.
126      That takes away time we better spend solving the problem; it
127      is easy to help us by providing a transcription
128      <p>
129
130  <li>If you are sure that your bug is MS Windows specific, please
131      enter the string "w32" into the <em>Topics</em> field.  You do
132      not need to do it if you select a Windows specific category (like
133      "gpgol").
134      <p>
135
136  <li>If you want to refer to an external bug description (for example
137      a similar entry in Debian's bug tracker), enter the URL into the
138      <em>ExtLink</em> field.
139      <p>
140
141  <li>If everything is as you want it, select the <em>Submit New
142      Entry</em> button.  This entry as well as all future changes will
143      also be mailed to you.
144      <p>
145 </ul>
146
147
148
149
150 <hr>
151 <div><font size="-1"> Contact information available at the <a
152 href="http://www.g10code.com">g10 Code main pages</a>.
153 <p>
154 Copyright (C) 2006 g10 Code GmbH, Erkrath-Hochdahl.<br>
155 Verbatim copying and distribution of this entire article is
156 permitted in any medium, provided this notice is preserved.
157 </font></div>
158 </body>
159 </html>