Report A Bug

September 1, 2018

Bug reporting is an important part of building and improving on this project. Mirror Island aims to be a community driven project that listens as much as possible towards its users.

First of all, bugs can come in many forms. Even if there isn't an actual software bug found but rather a user wasn't sure how to do something, that is important for us to know.

Secondly, bug reports don't have to be formal as long as they are informative. The quicker we can read bug reports the quicker we can fix any errors.

Since development on this website and related projects is done in a collaborative way, here are a few tips that can speed things up:

When reporting a bug, break it up in 4 parts:

  1. Describe what browser software and operating system you are using, and (if possible) the software version would be very helpful. It doesn't have to be specific and a description such as "I'm using Firefox on Android" would be sufficient.
  2. Describe what you thought was incorrect, and what should of happened.
  3. Describe the steps needed to repeat the bug. If you can't repeat the bug, at least describe what you did to the best of your recollection. Also describe how often it happens whether it always happens or only occasionally.
  4. A complete and identical copy of any error messages that may of been displayed. Take screenshots, if possible.

Once you have written out your bug report, you can send a copy of it by email to the address located on our Contact Us page.

Displayed below is an example bug report describing a fictitious error that occurs when a popup menu is displayed.

Sample Bug Report

I'm using Chromium on Debian, Windows 10, and macOS.

When I click on the menu icon the menu itself appears near the bottom of the screen instead of under the menu icon. This is what happened:

Start a new post and add anything to it. Photos, files, whatever.

Save the post.

Before refreshing the page, hover the mouse on the edit icon. The menu will popup near the bottom of the screen and it disappears before I can click on it.

This always happens no matter what OS I'm using, but only if I don't reload the page. Otherwise it goes away when the page loads again.

I can be contacted at computercat@example.com

Regards,
Felix