diff --git a/org.DolphinEmu.dolphin-emu.yml b/org.DolphinEmu.dolphin-emu.yml
index 4e44411..e4a69b0 100644
--- a/org.DolphinEmu.dolphin-emu.yml
+++ b/org.DolphinEmu.dolphin-emu.yml
@@ -9,15 +9,20 @@ rename-icon: dolphin-emu
 rename-appdata-file: dolphin-emu.appdata.xml
 finish-args:
   - --device=all
+  # the file picker uses portals but the set
+  # game directory feature still needs this
   - --filesystem=host:ro
   - --socket=pulseaudio
   - --socket=x11
   - --share=network
   - --share=ipc
+  # along with the bluez module, required for the
+  # emulated bluetooth adapter feature to work.
   - --allow=bluetooth
   - --filesystem=xdg-run/app/com.discordapp.Discord:create
   - --talk-name=org.freedesktop.ScreenSaver
 modules:
+  # needed for the bluetooth passthrough feature to work
   - name: libusb
     config-opts:
       - --disable-static
@@ -34,6 +39,7 @@ modules:
           project-id: 1749
           url-template: https://github.com/libusb/libusb/releases/download/v$version/libusb-$version.tar.bz2
 
+  # needed for the emulate bluetooth adapter feature to work
   - name: bluez
     config-opts:
       - --enable-library
@@ -58,6 +64,7 @@ modules:
           project-id: 10029
           url-template: https://www.kernel.org/pub/linux/bluetooth/bluez-$version.tar.xz
 
+  # needed for screensaver inhibition
   - name: xdg-screensaver-shim
     buildsystem: meson
     sources:
@@ -90,8 +97,12 @@ modules:
       - type: git
         url: https://github.com/dolphin-emu/dolphin.git
         commit: acc7d3710d60552769f61f4b44bc8533a940df36
+      # prevents dolphin from attempting to write conf files
+      # in non-writable paths, typically happens when a user
+      # has leftover files from a previous non-flatpak install
       - type: patch
         path: forcexdg.patch
+      # version strings must match exactly for online multiplayer
       - type: patch
         path: nodirtyversion.patch
       - type: file