diff --git a/docs/steamdeck/USAGE.md b/docs/steamdeck/USAGE.md
index b50b569..cf8bc9c 100644
--- a/docs/steamdeck/USAGE.md
+++ b/docs/steamdeck/USAGE.md
@@ -2,9 +2,9 @@
 
 Using Comet with Valve's Steam Deck (running SteamOS) is possible in both Desktop and Game Mode. Comet will only function with games that do support [GOG Galaxy's achievement system](https://www.gog.com/en/games?features=achievements) or any other online related functionality like Leaderboards. **If your game does not work out of the box, check Known Issues below.**
 
-Using `comet_shortcut.sh` will simplify the process of launching Heroic Games Launcher games with Comet in the background. That script works in both Modes.
+Using `comet_shortcut.sh` will simplify the process of launching GOG games from Heroic or Lutris with Comet in the background. That script works in both Modes.
 
-This instruction also applies for desktop users who want to use comet in launchers that do not support comet natively.
+This instruction also applies for desktop users. If you don't use any launcher see the project [README](https://github.com/imLinguin/comet#via-gogdl-cli) for manual credentials management.
 
 
 ## Installation steps
@@ -12,7 +12,7 @@ This instruction also applies for desktop users who want to use comet in launche
 1. Make sure you are logged into GOG on your launcher of choice.
 2. Download the latest release of Comet from [the latest release](https://github.com/imLinguin/comet/releases/latest) or [the latest GitHub Actions run](https://github.com/imLinguin/comet/actions/workflows/build.yml) labelled `comet-x86_64-unknown-linux-gnu` (a 64bit executable for Linux).
 3. Extract the downloaded archive to a desired place.
-   > It is recommended to have the `comet` binary put into the `~/Documents` directory. Otherwise: choose any directory where Heroic has access to.
+   > It is recommended to have the `comet` binary put into the `~/Documents` directory. Otherwise: choose any directory where your app of choice has access to.
 4. Open the `comet_shortcut.sh` file with Kate (right click on the file > Open with Kate), and edit the following values:
     - `gog_username`
         > Change the `username` value after `=` to your GOG username. If your name includes any special characters make sure to quote the username accordingly
diff --git a/docs/steamdeck/comet_shortcut.sh b/docs/steamdeck/comet_shortcut.sh
index e4f279f..3855289 100755
--- a/docs/steamdeck/comet_shortcut.sh
+++ b/docs/steamdeck/comet_shortcut.sh
@@ -16,13 +16,14 @@ path_to_comet='/home/deck/Documents/comet/comet'
 # Uncomment if debug logs are wanted to be visible in Comet
 #export COMET_LOG=debug
 # A timeout after which comet will quit when last client disconnects 
-export COMET_IDLE_WAIT=5 # 15 seconds is the default
+export COMET_IDLE_WAIT=5 # comet has a 15 seconds as the default, we make it shorter here, feel free to tweak it to your liking
 
 # Running Comet as a background app 
 # If you want to use this script in Lutris change --from-heroic to --from-lutris
 exec "$path_to_comet" --from-heroic --username "$gog_username" -q &
 
-# If parameters were provided we are in wrapper mode
+# This part allows using this script as a wrapper
+# e.g comet_shortcut.sh wine game.exe
 if [ $# -ne 0 ]; then
     comet_pid=$!
     exec "$@" &
diff --git a/docs/wiki/steamdeck/Usage.md b/docs/wiki/steamdeck/Usage.md
index b50b569..cf8bc9c 100644
--- a/docs/wiki/steamdeck/Usage.md
+++ b/docs/wiki/steamdeck/Usage.md
@@ -2,9 +2,9 @@
 
 Using Comet with Valve's Steam Deck (running SteamOS) is possible in both Desktop and Game Mode. Comet will only function with games that do support [GOG Galaxy's achievement system](https://www.gog.com/en/games?features=achievements) or any other online related functionality like Leaderboards. **If your game does not work out of the box, check Known Issues below.**
 
-Using `comet_shortcut.sh` will simplify the process of launching Heroic Games Launcher games with Comet in the background. That script works in both Modes.
+Using `comet_shortcut.sh` will simplify the process of launching GOG games from Heroic or Lutris with Comet in the background. That script works in both Modes.
 
-This instruction also applies for desktop users who want to use comet in launchers that do not support comet natively.
+This instruction also applies for desktop users. If you don't use any launcher see the project [README](https://github.com/imLinguin/comet#via-gogdl-cli) for manual credentials management.
 
 
 ## Installation steps
@@ -12,7 +12,7 @@ This instruction also applies for desktop users who want to use comet in launche
 1. Make sure you are logged into GOG on your launcher of choice.
 2. Download the latest release of Comet from [the latest release](https://github.com/imLinguin/comet/releases/latest) or [the latest GitHub Actions run](https://github.com/imLinguin/comet/actions/workflows/build.yml) labelled `comet-x86_64-unknown-linux-gnu` (a 64bit executable for Linux).
 3. Extract the downloaded archive to a desired place.
-   > It is recommended to have the `comet` binary put into the `~/Documents` directory. Otherwise: choose any directory where Heroic has access to.
+   > It is recommended to have the `comet` binary put into the `~/Documents` directory. Otherwise: choose any directory where your app of choice has access to.
 4. Open the `comet_shortcut.sh` file with Kate (right click on the file > Open with Kate), and edit the following values:
     - `gog_username`
         > Change the `username` value after `=` to your GOG username. If your name includes any special characters make sure to quote the username accordingly