Help:Reporting bugs

From semantic-mediawiki.org
Jump to: navigation, search
Table of Contents

Bugs for Semantic MediaWiki (SMW) should be filed at the issue tracking system provided by GitHub.1

How to report a problem

All bug reports should answer at least the following questions:

regarding the environment
  • Which version of Semantic MediaWiki is used?
  • Which version of a related semantic extensions is used? (If applicable.)
  • Which version of MediaWiki is used?
  • Which server setup was used (PHP, MySQL, Operating System)?
on examples for the bug
  • Can the problem be viewed online in a public wiki? (If yes, provide its URL.)
  • Can the problem be reproduced on a test page on a sandbox site? (If yes, provide its URL.)

We have created an issue reporting template that covers the items mentioned above to help you creating a quality issue report. It gets automatically loaded when starting to create a new issue etc..

Improvements and patches can also be discussed on the developer mailing list. You can also view the current bug list for Semantic MediaWiki online GitHub issue tracker. The bugs previously added to Bugzilla were transferred to GitHub.

How to get more information on your problem

Here are some tips to get more information on a problem, which will help us to solve it faster:

  • In general, it may also be useful to turn on debugging in MediaWiki. This should provide you with more instructive error messages in your log file.
  • If some page will not display correctly or causes critical errors, directly access the page in edit mode. To do that, edit any other page on your wiki and replace the page's name in the URL with the name of the broken page. Then try to remove parts of the page to find out what causes the problem, and include this in your bug report.
  • If you have a problem with Inline queries, try format=debug to gather useful information for the developers. Please send this output with your bug report.

See also