Annotate all the things

roles/desktop-common/tasks/packages.yml

@@ -25,16 +25,14 @@
     apt_repository:
       repo: "{{ item }}"
     loop:
-      # Spotify
+      # Debs
-      - "deb http://repository.spotify.com stable non-free"
+      - "deb http://repository.spotify.com stable non-free" # Spotify
-      # Monodevelop
+      - "deb https://download.mono-project.com/repo/ubuntu vs-bionic main" # Monodevelop
-      - "deb https://download.mono-project.com/repo/ubuntu vs-bionic main"
+      - "deb https://packages.riot.im/debian/ default main" # Element
-      # Element
-      - "deb https://packages.riot.im/debian/ default main"
       # First-party PPAs
       - "ppa:phoerious/keepassxc" # KeepassXC
       # Third-party PPAs
-      - "ppa:system76-dev/stable"
+      - "ppa:system76-dev/stable" # Love my lemp9
       - "ppa:drewwalton19216801/dolphin-master-cosmic" # Because Dolphin doesn't update their shit
       - "ppa:kgilmer/speed-ricer" # Rice rice rice
       - "ppa:lutris-team/lutris" # Lutris is kickass
@@ -52,22 +50,22 @@
         - build-essential
         - cmake
         - debhelper
-        - devscripts
+        - devscripts # Tons of cool shit in here, mostly for packaging tho
         - dh-make
         - earlyoom
         - fastboot
         - ffmpeg
         - git
         - imagemagick
-        - libinput-tools
+        - libinput-tools # Allows for libinput debugging
         - lua-check # I am good ComputerCraft guy
-        - neofetch
+        - neofetch # I never use it but whatever I guess
         - network-manager-openconnect
         - network-manager-openvpn
         - network-manager-vpnc # For default route configuration
-        - npm
+        - npm # I'm sorry
         - openjdk-8-jre # For Minecraft
-        - pbuilder
+        - pbuilder # Deb creation tool that does it all in a container
         - pwgen
         - python3-appdirs
         - python3-eyed3
@@ -75,10 +73,10 @@
         - python3-pyqt5
         - python3-usb # fuselee-gelee
         - python3-venv
-        - qt5-default # For Multimc, should be installed on Kubuntu
+        - qt5-default # For Multimc, should be installed on Kubuntu by default regardless
         - traceroute
         - tree
-        - units
+        - units # How many bytes are in a mile?
         - vim
         - wamerican # Dictionaries because I have like two scripts that use them
         - wamerican-large
@@ -96,76 +94,77 @@
         # DE
         - bspwm
         - compton
-        - conky-all
+        - conky-all # Why this is in several packages is beyond me
         - dunst
-        - hsetroot
+        - hsetroot # Works around a bug with Compton and a gray root window
-        - i3lock
+        - i3lock # Don't actually use this anymore (wew ksmserver)
         - ibus
-        - ibus-mozc
+        - ibus-mozc # Jap
-        - kubuntu-desktop
+        - kubuntu-desktop # Sanity
         - mozc-utils-gui
         - nitrogen
         - papirus-icon-theme
         - pavucontrol-qt
         - polybar
         - qt5ct
-        - xbacklight
+        - xbacklight # This works on literally none of my machines but fuck it
         # Desktop applications
-        - barrier
+        - barrier # FOSS Synergy
-        - cantata
+        - cantata # MPD client
         - chromium-browser
         - chromium-chromedriver # Because Selenium
         - clonezilla
         - dolphin-emu-master
         - dolphin-plugins
         - element-desktop
-        - filelight
+        - filelight # Sweet disk usage util
         - filezilla
         - firefox
-        - g810-led
+        - g810-led # For Logitech peripherals
         - gimp
-        - inkscape
+        - inkscape # I use it for like two things
-        - joy2key
+        - joy2key # Neat little wrapper to bind joypad keys to keyboard keys
         - joystick
         - kcolorchooser
-        - kde-config-plymouth
+        - kde-config-plymouth # Realistically not required, but whatever
-        - kdenlive
+        - kdenlive # For the one video I edit a year
         - kdepim
         - keepassxc
-        - krita
+        - krita # I don't ever end up using this, maybe I'll pick it up for spritework
-        - libnotify-bin
+        - libnotify-bin # Used for several of my scripts
         - libretro-desmume
         - libretro-mgba
         - libretro-mupen64plus
         - libretro-snes9x
         - lutris
         - mesa-vulkan-drivers
-        - mono-complete
+        - mono-complete # Initial installation of this package may take an eternity
         - monodevelop
         - mpv
         - mupen64plus-qt
         - nextcloud-desktop
         - obs-studio
-        - plymouth-theme-spinner
+        - plymouth-theme-spinner # Gives us the good UEFI logo bootup
-        - pulseeffects
+        - pulseeffects # I need to be an echoey boi
         - q4wine
         - qbittorrent
-        - rdesktop
+        - rdesktop # CLI RDP client, works real nice
         - redshift
         - retroarch
         - rofi
-        - scrot
+        - scrot # For scripted screenshots
         - spotify-client
         - steam-installer
         - syncthing-gtk
         - telegram-desktop
-        - torbrowser-launcher
+        - torbrowser-launcher # Sometimes it's bugged but it's still nice to have
         - virt-manager
         - vulkan-tools
         - vulkan-utils
         - winetricks
         - xdotool
         - zim
+        # Other architectures, misc
         - "libgl1-mesa-dri:i386"
         - "mesa-vulkan-drivers:i386"
         # Games