From 463b84b61c83cf27feadcd30932d3057749c24a4 Mon Sep 17 00:00:00 2001
From: hygienic-books <hygienic-books@tentic.net>
Date: Fri, 19 Sep 2025 02:05:23 +0200
Subject: [PATCH] docs(role): Add reminders/comments why we're installing
 packages

---
 defaults/main.yml | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/defaults/main.yml b/defaults/main.yml
index eef84cd..8278e7e 100644
--- a/defaults/main.yml
+++ b/defaults/main.yml
@@ -1,48 +1,92 @@
 # SPDX-License-Identifier: MIT
 packages_linux_common_all_families:
+    # A download manager more capable than wget
   - 'aria2'
+    # Shell-based math operations
   - 'bc'
+    # A nice system stats and health overview
   - 'btop'
+    # Brings mkfs.fat and related tools for the rare occasion that we absolutely
+    # have to work with a FAT-formatted partition.
   - 'dosfstools'
+    # DHCP server response debugging
   - 'dhcping'
+    # Fast host liveness scanner
   - 'fping'
+    # Version control
   - 'git'
+    # Network bandwidth and performance measurement
   - 'iperf3'
+    # Manipulate JSON
   - 'jq'
+    # All things FTP, SFTP, FTP over SSL etc.
   - 'lftp'
+    # Log file navigator
   - 'lnav'
+    # Process inspector
   - 'lsof'
+    # In-memory file transfer buffer
   - 'mbuffer'
+    # Advanced trace routes
   - 'mtr'
+    # ncurses disk usage
   - 'ncdu'
+    # Network performance measurement
   - 'netperf'
+    # Run multiple processes in parallel, mostly when they don't do so natively
+    # to better utilize CPU resources for a performance boost
   - 'parallel'
+    # Partition editor
   - 'parted'
+    # Apply patch files
   - 'patch'
+    # Parallel gzip
   - 'pigz'
+    # Pipe viewer to visualize network throughput inbetween two shell pipes
   - 'pv'
+    # Multi-purpose file transfer
   - 'rclone'
+    # Best-in-class data sync
   - 'rsync'
+    # Hardware stress testing
   - 'stress-ng'
+    # E-mail transfer debugging
   - 'swaks'
+    # System statistics and load monitor
   - 'sysstat'
+    # Network traffic inspector
   - 'tcpdump'
+    # Nice interface to WireShark CLI
   - 'termshark'
+    # Terminal multiplexer
   - 'tmux'
+    # Basic trace routes
   - 'traceroute'
+    # Print directory tree content
   - 'tree'
+    # Unzip zip files
   - 'unzip'
+    # Basic file transfer utility
   - 'wget'
 
 packages_linux_common_archlinux:
+    # We care about dig to debug DNS server responses
   - 'bind'
+    # A nicer CLI diff tool
   - 'difftastic'
+    # Better ls
   - 'eza'
+    # YAML file manipulation, diffs, merges etc.
   - 'go-yq'
+    # GPT disk editor
   - 'gptfdisk'
+    # Send crafted TCP packets for debugging purposes
   - 'openbsd-netcat'
+    # Allow a Proxmox VE hostto interact with a VM
   - 'qemu-guest-agent'
+    # Python manager
   - 'uv'
+    # WireShark CLI
   - 'wireshark-cli'
 
 packages_linux_paru_archlinux: