bugs
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
bugs [2015-04-08 11:55] – old revision restored (2014-02-27 13:17) 2001:4dd0:ff00:8eb9:6d6e:c3fd:21e2:7e03 | bugs [2017-10-27 21:07] – Aleksandr | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | :!: **Feb 26, 2014** --- DokuWiki | + | Every software |
- | [[DokuWiki]] uses [[https:// | + | ===== Make sure it is a Bug ===== |
- | Prior to Feb 26, 2014, DokuWiki used a different application | + | Before you report something, try to research if the problem you encounter really is a bug. Maybe it is intended behavior |
- | ===== Reporting Bugs ===== | + | You should also search the [[https:// |
+ | |||
+ | However, if still in doubt, just open a bug report. We can always close it should it turn out to not be a bug. | ||
+ | |||
+ | ===== Check if the problem is already reported | ||
+ | |||
+ | All DokuWiki bugs should be reported in our bug tracker at GitHub located at: [[https:// | ||
+ | |||
+ | Use the search to check if your problem already has been reported. Also make sure you search through closed bugs as well --- the bug might have been fixed already in development. | ||
+ | |||
+ | If the bug was reported already, check if you can provide additional information to aid fixing the bug. See below on how. | ||
+ | |||
+ | ===== Report a Bug ===== | ||
+ | |||
+ | As mentioned above, DokuWiki bugs **have** to be reported at [[https:// | ||
+ | |||
+ | When reporting a bug you should try to include as much information as possible that helps developers with identifying the problem. | ||
+ | |||
+ | This can include: | ||
- | When reporting bugs please always give as much of the following information as possible: | ||
* DokuWiki version | * DokuWiki version | ||
- | * OS | + | * Operating system of the server and client |
- | * Webserver and version | + | * The used web server |
- | * Web browser and version | + | * The used PHP version |
- | * and when asked, run '' | + | * The used browsers (try multiple) |
+ | * Everything that's special about your setup (plugins, auth backends, weird network config, etc.) | ||
+ | * Exact steps to reproduce | ||
+ | * Screenshots | ||
+ | |||
+ | It is especially important to gather exact error messages! See if you can find error logs from the web server and the JavaScript console | ||
+ | |||
+ | Please also read [[http://www.chiark.greenend.org.uk/~sgtatham/ | ||
+ | |||
+ | ===== How to obtain additional info ===== | ||
+ | |||
+ | As mentioned above, DokuWiki developers need detailed error messages to debug a problem. Sometimes those are printed directly to the screen, but sometimes they aren' | ||
+ | |||
+ | ==== Server/PHP Error Logs ==== | ||
+ | |||
+ | Whenever something goes fatally wrong, PHP will just stop processing your request. This usually results in a [[faq:blankpage|blank or partially rendered page]]. Sometimes errors are less grave but things are still missing. | ||
+ | |||
+ | In all of those cases PHP will log an error message to some log file. Where exactly that log file resides is different from system to system. Errors might be logged to the web server' | ||
+ | |||
+ | Typical locations are: | ||
+ | |||
+ | * '' | ||
+ | * ''/ | ||
+ | * '' | ||
+ | * ''/ | ||
+ | |||
+ | If you are on a hosted server, best ask your provider where to find that log. If you don't have access to '' | ||
+ | |||
+ | < | ||
+ | php_value display_errors 1 | ||
+ | php_value display_startup_errors 1 | ||
+ | </ | ||
- | **Tests Please:** if you are able, please attach a failing [[devel: | + | That may send the error message to the browser. |
- | Please read [[http:// | + | ==== JavaScript Console log ==== |
- | And remember: [[http:// | + | |
- | ===== How to use the bugtracking System ===== | + | Sometimes things go wrong on the client side (inside your browser). To figure out what, you will need to access the JavaScript console of your browser. To do so use the following keyboard shortcuts: |
- | First, make sure the bug or feature request isn't already there. Enter some keywords in the search box at the top, then filter | + | ^ Browser ^ Windows/ |
+ | | Chrome | ||
+ | | Firefox | '' | ||
+ | | Internet Explorer | '' | ||
+ | | Safari | ||
- | If you found an existing bugreport on " | + | If you see any errors (usually shown in red) in the console, go to your [[plugin: |
- | If you didn' | + | If you find errors in the JavaScript console you should always attach them to your bug report. |
===== Recently opened tasks ===== | ===== Recently opened tasks ===== | ||
- | {{rss>http://pipes.yahoo.com/pipes/pipe.run?_id=02bfefe73ba14054570ce82f1929e433&_render=rss&owner=splitbrain&repo=dokuwiki 1h date}} | + | [[http:// |
- | ==== Most recent task on old BTS ==== | + | {{rss> |
- | {{rss> |
bugs.txt · Last modified: 2023-12-12 22:58 by Aleksandr