Changes between Version 6 and Version 7 of Contributing/BugReporting

Timestamp:

10/12/2015 11:03:17 PM (9 years ago)

Author:

Cas

Comment:

updates to layout and text

Contributing/BugReporting

@@ -1 +1 @@
 = Before Reporting a Bug =
 
- * Install the latest stable version: '''[[Include(http://download.deluge-torrent.org/version)]]'''
+ * Install the latest stable version of Deluge: '''[[Include(http://download.deluge-torrent.org/version)]]'''
 
- * Check the '''[wiki:Faq FAQ]'''
+ * Check the '''[wiki:Faq Frequently Asked Questions]'''.
 
-== Search for Existing Issues ==
+== Search for existing issues ==
 
- * '''[search: Bug Tickets]'''
+''Frequently questions from users often relate to already fixed or known about bugs in Deluge so please search before asking.''
 
- * '''[http://forum.deluge-torrent.org/search.php Forum]'''
+ * '''[search: Deluge Bug Tickets]'''
 
- * Site search using [https://www.google.co.uk/search?q=site:deluge-torrent.org Search Engine]
+ * '''[http://forum.deluge-torrent.org/search.php Deluge Forum]'''
 
-'''Other bug trackers relating to Deluge:''' 
-
- * [https://bugs.launchpad.net/ubuntu/+source/deluge Ubuntu], [https://apps.fedoraproject.org/packages/deluge/bugs Fedora], [http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=deluge Debian], [https://bugs.archlinux.org/index.php?string=deluge Arch], [https://bugs.gentoo.org/buglist.cgi?quicksearch=deluge Gentoo], [http://trac.macports.org/query?status=assigned&status=new&status=reopened&order=priority&port=deluge MacPorts]
-
-'''libtorrent (rasterbar) Bugs:'''
-
- * [https://github.com/arvidn/libtorrent/issues libtorrent issue tracker], also [https://bugs.launchpad.net/ubuntu/+source/libtorrent-rasterbar Ubuntu], [https://admin.fedoraproject.org/pkgdb/acls/bugs/rb_libtorrent Fedora], [http://trac.macports.org/query?status=assigned&status=new&status=reopened&order=priority&port=libtorrent-rasterbar MacPorts]
+ * Deluge site search using [https://www.google.co.uk/search?q=site:deluge-torrent.org Search Engine]
 
 == Ask your Question Effectively ==
@@ -30 +24 @@
 = Collect Bug Information =
 
-You will need some/all of the following information when reporting a bug:
+You will need the following information when reporting a bug (at a minimum version):
+
+ * Version Information:
+    * [wiki:Troubleshooting#DelugeVersion Deluge]
+    * [wiki:Troubleshooting#libtorrentversion libtorrent]
+    * Operating System
+    * Browser ''(if using WebUI)''
+    * Plugins enabled
+    * Language in use ''(if not in English)''
+ * Installation type: ''source, package or installer''
+
+ * Precise steps to reproduce the bug.
+ * [wiki:Faq#EnableDelugeLogging Logs] either error level is usually fine
+ * Information of any errors or traces.
+ * [wiki:Faq#WheredoesDelugestoreitssettings Config files].
+ * Screenshots and screencasts are helpful for GUI issues.
 
 ''Note: If you are using Client and Daemon you may need version or logs from both.''
 
- * Version Information:
-    * Deluge
-    * [wiki:Faq#HowdoIfindwhatlibtorrentversionIamusing libtorrent]
-    * Operating System
-    * Browser ''(if using WebUI)''
-    * Plugins Enabled
-    * Language in use ''(i.e. if not English)''
- * Installation type: ''source, package or installer''
+== Hard crashes of Deluge (or libtorrent) ==
+A backtrace using `gdb` may be required for hard crashes of Deluge (crashes without an obvious error in Deluge logs).
 
- * Precise steps to reproduce the bug.
- * [wiki:Faq#EnableDelugeLogging Debug Logs] or copies of any errors or traces.
- * [wiki:Faq#WheredoesDelugestoreitssettings Config files].
- * Screenshots and screencasts can be helpful for GUI issues.
-
-== Hard crashes of deluge ==
-A backtrace using `gdb` may be required for hard crashes of Deluge (crashes without an obvious error). Here is a ''deluged'' example:
+Here is a ''deluged'' example:
 {{{
    gdb --args python /usr/bin/deluged -d
@@ -61 +58 @@
 The bug ticket system we use is called Trac. [/register Sign up] if you haven't already.
 
+If you encounter a register `Captcha Error` see: http://forum.deluge-torrent.org/viewtopic.php?f=7&t=51737
+
 ''Note: The Trac user account is separate to the Forum user account.''
 
@@ -71 +70 @@
  3. Attach any logs, screenshots or patches
 
+= External bug trackers =
+
+These sites also track bugs relating to Deluge or libtorrent.
+ 
+ * [https://bugs.launchpad.net/ubuntu/+source/deluge Ubuntu], [https://apps.fedoraproject.org/packages/deluge/bugs Fedora], [http://bugs.debian.org/cgi-bin/pkgreport.cgi?src=deluge Debian], [https://bugs.archlinux.org/index.php?string=deluge Arch], [https://bugs.gentoo.org/buglist.cgi?quicksearch=deluge Gentoo], [http://trac.macports.org/query?status=assigned&status=new&status=reopened&order=priority&port=deluge MacPorts]
+
+'''libtorrent (rasterbar) Bugs:'''
+
+ * [https://github.com/arvidn/libtorrent/issues libtorrent issue tracker], also [https://bugs.launchpad.net/ubuntu/+source/libtorrent-rasterbar Ubuntu], [https://admin.fedoraproject.org/pkgdb/acls/bugs/rb_libtorrent Fedora], [http://trac.macports.org/query?status=assigned&status=new&status=reopened&order=priority&port=libtorrent-rasterbar MacPorts]