docs: Add docstring to detect_gpu_and_display function

Author: MontaEllis8

tools/gpu_display_detector.py

@@ -1,9 +1,34 @@
+"""GPU and display detection for awarding legacy hardware badges."""
+
 import json
 import platform
 import subprocess
 from datetime import datetime
 
 def detect_gpu_and_display():
+    """Detects legacy GPU and display hardware and awards corresponding badges.
+    
+    This function scans the system using lspci to detect legacy GPU and display
+    adapters. When legacy hardware is detected, it creates badge entries for
+    each detected device and saves them to unlocked_badges.json.
+    
+    Supported GPU badges:
+        - Voodoo FX (3dfx Voodoo graphics)
+        - SLI (NVIDIA SLI)
+        - ATI Rage Pro
+        - Matrox
+        - PowerVR Prophet
+        - Amiga Warrior
+    
+    Supported Display badges:
+        - Hercules monochrome
+        - CGA (Color Graphics Adapter)
+        - XGA (Extended Graphics Array)
+        - VGA ancestor
+    
+    Returns:
+        None. Results are written to unlocked_badges.json file.
+    """
     badges = []
 
     try: