docs-validation.yml

name: Docs Validation Pipeline

on:
  push:
    branches: [ main, feat/docs-pipeline-42 ]
  pull_request:
    branches: [ main ]

jobs:
  validate-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          components: rustfmt
          targets: wasm32-unknown-unknown

      - name: Cache cargo
        uses: Swatinem/rust-cache@v2

      # 1. Link checking system (Temporarily disabled)
      # - name: Lychee Link Checker
      #   uses: lycheeverse/lychee-action@v1.9.0
      #   with:
      #     args: --config lychee.toml "./**/*.md"
      #     fail: true

      # 2. Validate code examples (per workspace member)
      - name: Verify Code Snippets (teachlink)
        run: cargo test --doc -p teachlink-contract
      - name: Verify Code Snippets (governance)
        run: cargo test --doc -p governance-contract
      - name: Verify Code Snippets (insurance)
        run: cargo test --doc -p enhanced-insurance