Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
report_issue [2022/07/04 13:58] – [Formal report] add extra dox locations atarireport_issue [2023/12/16 06:26] (current) – [What issue reports are NOT for] maximumentropy
Line 20: Line 20:
  
 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.
Line 69: Line 69:
 **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'' and your scraper API account is in ''system/es_settings.cfg'' and ''configs/emulationstation/es_settings.cfg''), 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 ===
  • report_issue.1656935886.txt.gz
  • Last modified: 21 months ago
  • by atari