Merge branch 'main' into patch-1

website/blog/release-notes/2024-02-24-release-notes-4.3.0/index.mdx

@@ -264,7 +264,7 @@ GnGeo is an Neo-Geo MVS and Neo-Geo AES standalone emulator. It supports GNO fil
 
 <Card readMore="../../docs/emulators/scummvm">
 
-#### ScummVM 2.9.0 Standalone (updated standalone emulator)
+#### ScummVM 2.9.0 Standalone (updated version of ScummVM project)
 <sup>
 
 by @XK9274 and @schmurtzm

website/docs/04-emulators/05-miscellaneous/13-scummvm.md

@@ -12,17 +12,23 @@ slug: /emulators/scummvm
 
 ---
 
+Although included in the "Emulators" section of this documentation for practical reasons, ScummVM project is not an emulator but a complete rewrite of the games executables. In other terms each game launched by ScummVM works like a port with its own dedicated engine. This implementation offers a rendering of games that's very close to the original rendering, with higher performance than you'd expect from an emulator. To play to ScummVM in the best conditions it is recommended to not use modified game assets. 
+
+For more details about ScummVM, the [official FAQ](https://docs.scummvm.org/en/latest/help/faq.html) and [the official wiki](https://wiki.scummvm.org) are a good start.
+
 ### Adding games
 
 No need to create your shortcuts manually anymore, Onion will import your games automatically ! 
 Just put your games folders in `Roms/SCUMMVM/[Game folder]/` and then run `~Import games` in ScummVM section. 
 
+ScummVM documentation offers great ressources to learn how to add games to ScummVM : This article "[Where to get the games](https://wiki.scummvm.org/index.php?title=Where_to_get_the_games)" and the [list of supported games](https://wiki.scummvm.org/index.php?title=Category:Supported_Games) will help you to know which files to copy from your original game to get it working properly on ScummVM.
+
 The import script will ask you if you want to use ScummVM database names or the names specified on your own folders. 
 As ScummVM games names are often long (with details about version and language as `Full Throttle (Version A, English)`) you can also choose to remove parens.
 
 ### Audio troubleshooting
 
-We recommend sourcing original `.sou` audio files for `Full Throttle`, `The Dig` and `The Curse of Monkey Island` to avoid audio issues (such as missing speech or dropping out).  
+ScummVM project doesn't support modified game assets so we recommend to use original `.sou` uncompressed audio files for `Full Throttle`, `The Dig` and `The Curse of Monkey Island` to avoid audio issues (such as missing speech or dropping out).  
 
 
 ### Speed troubleshooting
@@ -31,6 +37,6 @@ On demanding games like Grim Fandango, you can adjust "Target FPS for stutter re
 
 
 :::note
-ScummVM Standalone (not a RetroArch core but the classical emulator) can be found in the "Expert" section of [Package Manager](../apps/package-manager). It offers much improved performances (Grim, Monkey Island 4 or Blade Runner works perfectly).
+ScummVM Standalone (not a RetroArch core but the native ScummVM reimplementation) can be found in the "Expert" section of [Package Manager](../apps/package-manager). It offers much improved performances (Grim, Monkey Island 4 or Blade Runner works perfectly).
 However its integration in Onion is not perfect : no automatic save states, no resume at boot , different shortcuts...
 :::