docs: Add comprehensive section comments to all GitHub workflows and configurations

- Add clear section markers (=======================) to all 13 workflows
- Document purpose, triggers, and features for each workflow
- Improve workflow organization and readability
- Standardize documentation format across all workflows and configs

All GitHub workflows and configurations now have comprehensive documentation.

Author: github-actions[bot]

.github/CODEOWNERS

@@ -1,5 +1,9 @@
-# You can use this CODEOWNERS file to define individuals or teams that are responsible for code in a repository.
-
-# See https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+# =======================
+# FORRT CODEOWNERS Configuration
+# =======================
+# Purpose: Defines code ownership and review requirements
+# Documentation: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+# Used by: GitHub for automatic review assignment
 
+# Global rule: All files require review from the website team
 * @forrtproject/team-website

.github/labeler.yaml

@@ -1,16 +1,27 @@
+# =======================
+# GitHub Labeler Configuration
+# =======================
+# Purpose: Defines automatic labeling rules for PRs and issues
+# Used by: labeler.yaml workflow
+# Rules: Based on branch names and changed file paths
+
+# Bug-related branches
 bug:
  - head-branch: ['^bug', 'bug', '^hotfix', 'hotfix']
 
+# CI/CD workflow changes
 cicd:
 - changed-files:
   - any-glob-to-any-file:
     - .github/workflows/*
 
+# Content and documentation changes
 content related:
 - changed-files:
   - any-glob-to-any-file:
     - content/**/*
 
+# Documentation files
 documentation:
 - changed-files:
   - any-glob-to-any-file:
@@ -20,5 +31,6 @@ documentation:
     - .github/ISSUE_TEMPLATE/*
     - .github/CODEOWNERS
 
+# Feature enhancement branches
 enhancement:
  - head-branch: ['^feature', 'feature']

.github/workflows/check_images.yaml

@@ -1,5 +1,12 @@
 name: Check Images in PR
 
+# =======================
+# Image Validation Workflow
+# =======================
+# Purpose: Validates image files and references in pull requests
+# Triggers: PR opened, synchronized, or reopened
+# Checks: Image format, size, accessibility, and broken references
+
 on:
   pull_request:
     types: [opened, synchronize, reopened]

.github/workflows/close-stale.yml

@@ -1,5 +1,12 @@
 name: close-stale
 
+# =======================
+# Stale Issue Management
+# =======================
+# Purpose: Automatically closes stale issues and pull requests
+# Triggers: Daily at 2 AM UTC or manual dispatch
+# Features: Marks inactive items as stale, then closes them after 7 days
+
 on:
   schedule:
   - cron: '0 2 * * *'

.github/workflows/data-processing.yml

@@ -20,9 +20,15 @@ jobs:
     env:
       PYTHON_VERSION: "3.11"
     steps:
+      # =======================
+      # Repository Setup
+      # =======================
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      # =======================
+      # Workflow Configuration
+      # =======================
       - name: Check if monthly run
         id: monthly-run
         run: |
@@ -35,6 +41,9 @@ jobs:
             echo "🔄 Monthly run detected - will run contributor analysis"
           fi
 
+      # =======================
+      # Environment Setup
+      # =======================
       - name: Configure Git
         run: |
           git config --global user.email "mudaherarich@gmail.com"
@@ -52,6 +61,9 @@ jobs:
       - name: Install tenzing R dependencies
         run: Rscript -e 'install.packages(c("rmarkdown","ggplot2", "readxl", "dplyr", "googlesheets4", "stringr", "gridExtra", "glue", "tidygraph", "ggraph", "igraph", "visNetwork"))'
 
+      # =======================
+      # Contributor Analysis (Monthly)
+      # =======================
       - name: Run Contributor Analysis
         if: steps.monthly-run.outputs.is_monthly == 'true'
         continue-on-error: true  # Continue even if this step fails
@@ -79,6 +91,9 @@ jobs:
           
           echo "✅ Contributor analysis complete"
 
+      # =======================
+      # Tenzing Data Processing
+      # =======================
       - name: Install Python dependencies
         run: python3 -m pip install -r ./requirements.txt
 
@@ -109,6 +124,9 @@ jobs:
             fi
           done
 
+      # =======================
+      # Google Analytics Data
+      # =======================
       - name: Download GA Data
         continue-on-error: true  # Continue even if this step fails
         env:
@@ -185,12 +203,18 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.FORRT_PAT }}
           GH_TOKEN: ${{ secrets.FORRT_PAT }}
 
+      # =======================
+      # Google Scholar Citations
+      # =======================
       - name: Run Google Scholar script
         continue-on-error: true
         run: python3 scripts/gs-cite/google_scholar.py
         env:
           SERPAPI: ${{ secrets.SERPAPI }}
 
+      # =======================
+      # Artifact Upload
+      # =======================
       - name: Upload data artifact
         id: upload-artifact
         uses: actions/upload-artifact@v4

.github/workflows/deploy.yaml

@@ -1,5 +1,12 @@
 name: deploy
 
+# =======================
+# FORRT Website Deployment
+# =======================
+# Purpose: Build and deploy the FORRT Hugo website
+# Triggers: Push to master, PRs, or manual dispatch
+# Target: Production deployment
+
 on:
   push:
     branches:
@@ -25,12 +32,18 @@ jobs:
       HUGO_VERSION: "0.123.3"
       HUGO_EXTENDED: true
     steps:
+      # =======================
+      # Repository Setup
+      # =======================
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
           ref: ${{ github.event.inputs.pr_number || github.ref }}
           fetch-depth: 0
 
+      # =======================
+      # Data Artifact Retrieval
+      # =======================
       - name: Try to download data artifact
         id: download-artifact
         uses: dawidd6/action-download-artifact@07ab29fd4a977ae4d2b275087cf67563dfdf0295
@@ -41,6 +54,9 @@ jobs:
           path: .
           github_token: ${{ secrets.GITHUB_TOKEN }}
 
+      # =======================
+      # Fallback Data Processing
+      # =======================
       - name: Run data processing if needed
         if: steps.download-artifact.outcome == 'failure'
         env:
@@ -67,12 +83,18 @@ jobs:
           fi
 
 
+      # =======================
+      # Hugo Build Environment
+      # =======================
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@75d2e84710de30f6ff7268e08f310b60ef14033f
         with:
           hugo-version: ${{ env.HUGO_VERSION }}
           extended: ${{ env.HUGO_EXTENDED }}
 
+      # =======================
+      # Website Build
+      # =======================
       - name: Build site
         run: |
           if [ "$BRANCH" != 'refs/heads/master' ]; then
@@ -83,6 +105,9 @@ jobs:
         env:
           BRANCH: ${{ github.ref }}
 
+      # =======================
+      # Deployment Artifact
+      # =======================
       - name: Upload site artifact
         uses: actions/upload-artifact@v4
         with:

.github/workflows/gemini-dispatch.yml

@@ -1,5 +1,12 @@
 name: '🔀 Gemini Dispatch'
 
+# =======================
+# AI Assistant Dispatch
+# =======================
+# Purpose: Dispatches AI assistant requests from PR comments and reviews
+# Triggers: PR review comments, PR reviews, and PR events
+# Features: AI command parsing and workflow triggering
+
 on:
   pull_request_review_comment:
     types:

.github/workflows/gemini-invoke.yml

@@ -1,5 +1,12 @@
 name: '▶️ Gemini Invoke'
 
+# =======================
+# AI Assistant Invocation
+# =======================
+# Purpose: Invokes AI assistant for code analysis and suggestions
+# Triggers: Called by other workflows (workflow_call)
+# Features: AI-powered code review and automated feedback
+
 on:
   workflow_call:
     inputs:

.github/workflows/gemini-review.yml

@@ -1,5 +1,12 @@
 name: '🔎 Gemini Review'
 
+# =======================
+# AI-Powered Code Review
+# =======================
+# Purpose: Provides automated code review using Google Gemini AI
+# Triggers: Called by other workflows (workflow_call)
+# Features: Code analysis, suggestions, and automated feedback
+
 on:
   workflow_call:
     inputs:

.github/workflows/gemini-triage.yml

@@ -1,5 +1,12 @@
 name: '🔀 Gemini Triage'
 
+# =======================
+# AI-Powered Issue Triage
+# =======================
+# Purpose: Automatically triages issues and PRs using AI
+# Triggers: Called by other workflows (workflow_call)
+# Features: AI-powered categorization, labeling, and routing
+
 on:
   workflow_call:
     inputs: