Adding comprehensive comments

stirling-pdf/docker-compose.yml

@@ -1,26 +1,35 @@
+# Stirling PDF Service Configuration
 services:
   stirling-pdf:
+    # Basic container configuration
     container_name: stirling-pdf
-    image: ghcr.io/stirling-tools/stirling-pdf:1.0.2-fat
-    restart: unless-stopped
+    image: ghcr.io/stirling-tools/stirling-pdf:1.0.2-fat  # Full-featured image
+    restart: unless-stopped  # Auto-recover from crashes
+    
+    # Application settings
     environment:
-      - DISABLE_ADDITIONAL_FEATURES=${DISABLE_ADDITIONAL_FEATURES}
-      - DOCKER_ENABLE_SECURITY=${DOCKER_ENABLE_SECURITY}
-      - SECURITY_ENABLELOGIN=${SECURITY_ENABLELOGIN}
-      - LANGS=${LANGS}
-      - SHOW_SURVEY=false
-      - DISABLE_PIXEL=true
+      - DISABLE_ADDITIONAL_FEATURES=${DISABLE_ADDITIONAL_FEATURES}  # Toggle extra features
+      - DOCKER_ENABLE_SECURITY=${DOCKER_ENABLE_SECURITY}  # Enable security restrictions
+      - SECURITY_ENABLELOGIN=${SECURITY_ENABLELOGIN}  # Require authentication
+      - LANGS=${LANGS}  # Supported languages for OCR
+      - SHOW_SURVEY=false  # Disable user surveys
+      - DISABLE_PIXEL=true  # Disable pixel tracking
+    
+    # Persistent storage configuration
     volumes:
-      - ${APPDATA_DATA}/stirling-pdf/training_data:/usr/share/tessdata
-      - ${APPDATA_DATA}/stirling-pdf/config:/configs
-      - ${APPDATA_DATA}/stirling-pdf/custom_files:/customFiles/
-      - ${APPDATA_DATA}/stirling-pdf/logs:/logs/
-      - ${APPDATA_DATA}/stirling-pdf/pipeline:/pipeline/
+      - ${APPDATA_DATA}/stirling-pdf/training_data:/usr/share/tessdata  # OCR training data
+      - ${APPDATA_DATA}/stirling-pdf/config:/configs  # Configuration files
+      - ${APPDATA_DATA}/stirling-pdf/custom_files:/customFiles/  # User uploads
+      - ${APPDATA_DATA}/stirling-pdf/logs:/logs/  # Application logs
+      - ${APPDATA_DATA}/stirling-pdf/pipeline:/pipeline/  # Processing pipelines
+    
+    # Network configuration
     ports:
-      - ${PORT}:8080
+      - ${PORT}:8080  # Web interface port
     networks:
-      - frontend
+      - frontend  # Connects to frontend network
 
+# External network definition
 networks:
   frontend:
-    external: true
+    external: true  # Uses existing Docker network