Where and how to file bug reports

Get technical support from the community & developers with specific X16 programs if you can't find the solution elsewhere
(for general non-support related chat about programs please comment directly under the program in the software library)
Post Reply
TomXP411
Posts: 1785
Joined: Tue May 19, 2020 8:49 pm

Where and how to file bug reports

Post by TomXP411 »


The Commander X16 software is being developed via GitHub.

If you encounter a problem with the emulator or the system ROM, start by posting a topic here. If other users can't help fix your problem, the next step is to file a bug report. 

Bug reports should be filed in the correct location for the bug. Issues with the system software (ie: a BASIC command doesn't work as expected) should be filed to the ROM repository. Issues with the emulator (crashes or incorrect or inaccurate behavior) should be filed to the emulator repository. Likewise, documentation errors or incomplete documentation goes in the docs repo.

Follow the SID method when filing a bug report:


  1. Search for an existing issue that covers the same problem. Do not file a new bug report if there's already one out there that covers the issue. You don't need to "me too" it, unless you have new information that will help identify or fix the bug. 


  2. Include detailed reproduction steps. Include enough detail that other people can reproduce and test the problem. If your bug requires specific data or program code, be prepared to attach that to the bug report. 


  3. Discuss it first in the support forum. Many bugs turn out to be mistakes in our own program or our own understanding of the KERNAL or the hardware.


 

Post Reply