docs.yml

name: Docs

on:
  push:
    branches:
      - master
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review, labeled]
  merge_group:

concurrency:
  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  # preflight:
  # if: contains(github.event.label.name, 'GHA-migration')
  # uses: ./.github/workflows/reusable-preflight.yml

  # test-rustdoc:
  #   runs-on: ${{ needs.preflight.outputs.RUNNER }}
  #   if: ${{ needs.preflight.outputs.changes_rust }}
  #   needs: [preflight]
  #   container:
  #     image: ${{ needs.preflight.outputs.IMAGE }}
  #   steps:
  #     - uses: actions/checkout@v4
  #     - run: forklift cargo doc --workspace --all-features --no-deps
  #       env:
  #         SKIP_WASM_BUILD: 1
  # test-doc:
  #   runs-on: ${{ needs.preflight.outputs.RUNNER }}
  #   needs: [preflight]
  #   container:
  #     image: ${{ needs.preflight.outputs.IMAGE }}
  #   steps:
  #     - uses: actions/checkout@v4
  #     - run: forklift cargo test --doc --workspace
  #       env:
  #         RUSTFLAGS: "-Cdebug-assertions=y -Dwarnings"

  # build-rustdoc:
  #   runs-on: ${{ needs.preflight.outputs.RUNNER }}
  #   if: ${{ needs.preflight.outputs.changes_rust }}
  #   needs: [preflight, test-rustdoc]
  #   container:
  #     image: ${{ needs.preflight.outputs.IMAGE }}
  #   steps:
  #     - uses: actions/checkout@v4
  #     - run: forklift cargo doc --all-features --workspace --no-deps
  #       env:
  #         SKIP_WASM_BUILD: 1
  #         RUSTDOCFLAGS: "-Dwarnings --default-theme=ayu --html-in-header ./docs/sdk/assets/header.html --extend-css ./docs/sdk/assets/theme.css --html-after-content ./docs/sdk/assets/after-content.html"
  #     - run: rm -f ./target/doc/.lock
  #     - run: mv ./target/doc ./crate-docs
  #     - name: Inject Simple Analytics script
  #       run: |
  #         script_content="<script async defer src=\"https://apisa.parity.io/latest.js\"></script><noscript><img src=\"https://apisa.parity.io/latest.js\" alt=\"\" referrerpolicy=\"no-referrer-when-downgrade\" /></noscript>"
  #         docs_dir="./crate-docs"

  #         inject_simple_analytics() {
  #           find "$1" -name '*.html' | xargs -I {} -P "$(nproc)" bash -c 'file="{}"; echo "Adding Simple Analytics script to $file"; sed -i "s|</head>|'"$2"'</head>|" "$file";'
  #         }

  #         inject_simple_analytics "$docs_dir" "$script_content"
  #     - run: echo "<meta http-equiv=refresh content=0;url=polkadot_sdk_docs/index.html>" > ./crate-docs/index.html
  #     - uses: actions/upload-artifact@v4
  #       with:
  #         name: ${{ github.sha }}-doc
  #         path: ./crate-docs/
  #         retention-days: 1
  #         if-no-files-found: error

  # build-implementers-guide:
  #   runs-on: ubuntu-latest
  #   container:
  #     image: paritytech/mdbook-utils:e14aae4a-20221123
  #     options: --user root
  #   steps:
  #     - uses: actions/checkout@v4
  #     - run: mdbook build ./polkadot/roadmap/implementers-guide
  #     - run: mkdir -p artifacts
  #     - run: mv polkadot/roadmap/implementers-guide/book artifacts/
  #     - uses: actions/upload-artifact@v4
  #       with:
  #         name: ${{ github.sha }}-guide
  #         path: ./artifacts/
  #         retention-days: 1
  #         if-no-files-found: error

  publish-rustdoc:
    # if: github.ref == 'refs/heads/master'
    runs-on: ubuntu-latest
    # environment: subsystem-benchmarks
    # needs: [preflight]
    steps:
      - uses: actions/checkout@v4
        with:
          ref: gh-pages
      - uses: actions/create-github-app-token@v1
        id: app-token
        with:
          app-id: ${{ secrets.POLKADOTSDK_GHPAGES_APP_ID }}
          private-key: ${{ secrets.POLKADOTSDK_GHPAGES_APP_KEY }}
      - name: Create test file
        env:
          TOKEN: ${{ steps.app-token.outputs.token }}
        run: |
          curl -H "Authorization: token ${TOKEN}" https://api.github.com/user
          ls -la
          echo ${{ github.sha }} > ${{ github.sha }}.txt
          git status
          echo "Git config"
          cat .git/config
          echo "Add new remote"
          git remote remove origin
          git remote add origin https://${TOKEN}@github.com/paritytech-stg/polkadot-sdk
          echo "Git config"
          cat .git/config
          echo "Git push"
          git config --global user.email "ci@parity.io"
          git config --global user.name "polkadotsdk-ghpages"
          git add ${{ github.sha }}.txt
          git commit -m "___Updated docs for ${{ github.head_ref || github.ref_name }}___"
          git push origin gh-pages
      # - name: Ensure destination dir does not exist
      #   run: |
      #     rm -rf book/
      #     rm -rf ${REF_NAME}
      #   env:
      #     REF_NAME: ${{ github.head_ref || github.ref_name }}
      # - name: Download rustdocs
      #   uses: actions/download-artifact@v4
      #   with:
      #     name: ${{ github.sha }}-doc
      #     path: ${{ github.head_ref || github.ref_name }}
      # - name: Download guide
      #   uses: actions/download-artifact@v4
      #   with:
      #     name: ${{ github.sha }}-guide
      #     path: /tmp
      # - run: mkdir -p book
      # - name: Move book files
      #   run: mv /tmp/book/html/* book/
      # - name: Push to GH-Pages branch
      #   uses: github-actions-x/commit@v2.9
      #   with:
      #     github-token: ${{ steps.app-token.outputs.token }}
      #     push-branch: "gh-pages"
      #     commit-message: "___Updated docs for ${{ github.head_ref || github.ref_name }}___"
      #     # force-add: "true"
      #     # files: ${{ github.head_ref || github.ref_name }}/ book/
      #     files: ${{ github.sha }}.txt
      #     name: polkadotsdk-ghpages
      #     email: devops-team@parity.io