Add auto-generated documentation site for workflows and actions

[ssestak]

Summary

Adds a MkDocs Material documentation site that auto-generates markdown pages for all reusable workflows and composite actions. The site is deployed via GitHub Pages on every push to main.

Changes

• Auto-discovery in config.py scans the filesystem instead of a hand-maintained registry — adding a new workflow or action requires zero config changes
• YAML parsers extract inputs, secrets, outputs, permissions, and triggers
• Jinja2 templates render workflow and action pages with usage snippets, cross-links, and deprecation banners
• Enricher pipeline supports README embedding and optional AI summaries
• deploy-docs.yml workflow builds and deploys on push to main or tags
• Uses pip cache via actions/setup-python@v6 instead of a no-op mkdocs cache

Diagram

Doc generation pipeline

flowchart TD
    A[deploy-docs.yml] --> B[checkout\@v6]
    B --> C[<br>setup-python@v6<br/>pip cache]
    C --> D[generate-docs.py]
    D --> E[config.py<br/>auto-discover]
    E --> F[Parse YAMLs<br/>workflow + action]
    F --> G[Enrich<br/>README / AI]
    G --> H[Render Markdown<br/>Jinja2 templates]
    H --> I[mkdocs gh-deploy]

Loading

Auto-discovery logic

flowchart LR
    subgraph Workflows
        W1[workflows/*.yml] --> W2[Skip EXCLUDE]
        W2 --> W3[Match category prefix]
        W3 --> W4[Parse YAML name<br/>Derive runner<br/>Check workflow_call]
        W4 --> W5[Merge OVERRIDES]
        W5 --> WR[WORKFLOWS dict]
    end

    subgraph Actions
        A1[actions/*/action.yml] --> A2[Match category prefix]
        A2 --> A3[Parse YAML name<br/>Detect README]
        A3 --> A4[Merge OVERRIDES]
        A4 --> AR[ACTIONS dict]
    end

Loading

[jmarek41]

😍