summaryrefslogtreecommitdiff
path: root/readme.txt
diff options
context:
space:
mode:
Diffstat (limited to 'readme.txt')
-rw-r--r--readme.txt54
1 files changed, 35 insertions, 19 deletions
diff --git a/readme.txt b/readme.txt
index 00b18aa79..42d77de56 100644
--- a/readme.txt
+++ b/readme.txt
@@ -49,25 +49,41 @@ http://forum.openttd.org/
2.1) Reporting Bugs:
---- ---------------
-To report a bug, please create a Flyspray account and follow the bugs
-link from our homepage. Please make sure the bug is reproducible and
-still occurs in the latest daily build or the current SVN version. Also
-please look through the existing bug reports briefly to see whether the bug
-is not already known.
-
-The Flyspray project page URL is: http://bugs.openttd.org/
-
-Please include the following information in your bug report:
- - OpenTTD version (PLEASE test the latest SVN/nightly build)
- - Bug details, including instructions how to reproduce it
- - Platform and compiler (Win32, Linux, FreeBSD, ...)
- - Attach a saved game *and* a screenshot if possible
- - If this bug only occurred recently please note the last
- version without the bug and the first version including
- the bug. That way we can fix it quicker by looking at the
- changes made.
- - Attach crash.dmp, crash.log and crash.sav from the data
- directory if they exist.
+First of all, check whether the bug is not already known. Do this by looking
+through the file called 'known-bugs.txt' which is distributed with OpenTTD
+like this readme.
+
+For tracking our bugs we are using a bug tracker called Flyspray. You can find
+the tracker at http://bugs.openttd.org/. Before actually reporting take a look
+through the already reported bugs there to see if the bug is already known.
+The 'known-bugs.txt' file might be a bit outdated at the moment you are
+reading it as only bugs known before the release are documented there. Also
+look through the recently closed bugs.
+
+When you are sure it is not already reported you should:
+ * Make sure you are running a recent version, i.e. run the latest stable or
+ nightly based on where you found the bug.
+ * Make sure you are not running a non-official binary, like a patch pack.
+ When you are playing with a patch pack you should report any bugs to the
+ forum thread related to that patch pack.
+ * Make it reproducable for the developers. In other words, create a savegame
+ in which you can reproduce the issue once loaded. It is very useful to give
+ us the crash.dmp, crash.sav and crash.log which are created on crashes.
+ * Check whether the bug is already reported on our bug tracker. This includes
+ searching for recently closed bug reports as the bug might already be fixed.
+
+After you have done all that you can report the bug. Please include the
+following information in your bug report:
+ * OpenTTD version (PLEASE test the latest SVN/nightly build)
+ * Bug details, including instructions how to reproduce it
+ * Platform (Win32, Linux, FreeBSD, ...) and compiler (including version) if
+ you compiled OpenTTD yourself.
+ * Attach a saved game *and* a screenshot if possible
+ * If this bug only occurred recently please note the last version without
+ the bug and the first version including the bug. That way we can fix it
+ quicker by looking at the changes made.
+ * Attach crash.dmp, crash.log and crash.sav. These files are usually created
+ next to your openttd.cfg. The crash handler will tell you the location.
2.2) Reporting Desyncs:
---- ------------------