Both sides previous revision Previous revision Next revision | Previous revision |
report_issue [2022/03/26 02:33] – link in a more obvious spot atari | report_issue [2023/12/16 06:26] (current) – [What issue reports are NOT for] maximumentropy |
---|
| |
Here is a list of things you should **not** use the issues page for and the alternative location for them: | Here is a list of things you should **not** use the issues page for and the alternative location for them: |
* Feature requests should instead be put in the #wish channel on [[https://discord.com/invite/JXhfRTr|the Discord server]] or [[https://forum.batocera.org/|the forum]]. | * Feature requests should instead be put in the [[https://discord.gg/V7j6vPG85N|#batocera-linux-requests channel on the Discord server]]. |
* Implementation/PR assistance (for developing Batocera) should instead be guided towards the #developers / #developers-emulationstation channel on the Discord. | * Implementation/PR assistance (for developing Batocera) should instead be guided towards the #developers and #developers-emulationstation channel on the Discord. |
* Issues specific to the emulator and the game it is running. Usually they should be reported to the dev of the emulator itself, as it is outside of the scope of Batocera. This includes things such as "weird geometry corruption in my Dreamcast game!" and "textures look weird on my PS2 game in PCSX2 but not Libretro/PCSX2". These emulators usually have their own documentation/wiki that you can check for and troubleshoot with instead first, it is recommended to do your research. | * Issues specific to the emulator and the game it is running. Usually they should be reported to the dev of the emulator itself, as it is outside of the scope of Batocera. This includes things such as "weird geometry corruption in my Dreamcast game!" and "textures look weird on my PS2 game in PCSX2 but not Libretro/PCSX2". These emulators usually have their own documentation/wiki that you can check for and troubleshoot with instead first, it is recommended to do your research. |
* Issues specific to EmulationStation (Batocera's front-end, the "main menu" essentially) should go to the [[https://github.com/batocera-linux/batocera-emulationstation|Github issue page specific to it]] instead. This includes things such as images appearing as white squares, text corrections, menu functions not behaving as intended, etc. | * Issues specific to EmulationStation (Batocera's front-end, the "main menu" essentially) should go to the [[https://github.com/batocera-linux/batocera-emulationstation|Github issue page specific to it]] instead. This includes things such as images appearing as white squares, text corrections, menu functions not behaving as intended, etc. |
**Logs and data:** Provide all the [[:troubleshooting#emulators_not_launching_emulationstation_logs|relevant logs]] and information relevant to the issue. Include any information about the platform you are on, the hardware being used (most applicable for x86 and x86_64 platforms), the stable versions of Batocera the issue is present/not present on, whether the issue is present on a fresh install or not, etc. | **Logs and data:** Provide all the [[:troubleshooting#emulators_not_launching_emulationstation_logs|relevant logs]] and information relevant to the issue. Include any information about the platform you are on, the hardware being used (most applicable for x86 and x86_64 platforms), the stable versions of Batocera the issue is present/not present on, whether the issue is present on a fresh install or not, etc. |
| |
If you are not certain which logs are relevant or the logs you do have don't describe the issue, [[:troubleshooting#create_a_batocera_support_file|create a support file]] instead. Do note that this file can contain personal information (your Wi-Fi SSID and password is in ''system/batocera.conf'' and ''system/batocera-boot.conf'', your RetroAcheivements username and password are in ''system/batocera.conf''), so be sure to either scrub it first if the issue isn't relevant to that information or just use a temporary password to be changed after the report. A fresh flash of Batocera doesn't have any personal info in it yet. | If you are not certain which logs are relevant or the logs you do have don't describe the issue, [[:troubleshooting#create_a_batocera_support_file|create a support file]] instead. Do note that this file can contain the following personal information: |
| * Your IP address is in ''system/ifconfig.txt'', ''system/messages'' and ''system/netstat.txt'' |
| * Your Wi-Fi SSID and password is in ''system/batocera.conf'' and ''system/batocera-boot.conf'' |
| * Your RetroAchievements username and password are in ''system/batocera.conf'', ''configs/retroarch/retroarchcustom.cfg'' and any configuration override files if you've made them |
| * Your scraper API account is in ''system/es_settings.cfg'' and ''configs/emulationstation/es_settings.cfg'' |
| * Your NAS login details are in ''system/batocera-boot.conf'' |
| |
| Be sure to either scrub it first if the issue isn't relevant to that information or just use a temporary password to be changed after the report. |
| |
=== Example of a good report === | === Example of a good report === |
<WRAP center round info> | <WRAP center round info> |
A timeline of when certain changes are allowed to be merged upstream can be found here: https://batocera.org/timeline | A timeline of when certain changes are allowed to be merged upstream can be found here: https://batocera.org/timeline |
| |
| A list of platforms Batocera is currently available on can be found here: https://mirrors.o2switch.fr/batocera/installs.txt |
</WRAP> | </WRAP> |
| |