generate-docs.yml

name: Generate Documentation

on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  generate_docs:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Set up Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.8'

      - name: Install Docsible
        run: |
          pip install git+https://github.com/docsible/docsible.git@name-prefix-in-ansible-lint

      - name: Generate documentation for role
        run: |
          docsible -r ./ -g -o README.md -a -com

      - name: Check for documentation changes
        run: |
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add README.md
          if git diff --exit-code; then
            echo "No changes to commit";
            exit 0;
          fi

      - name: Commit and push documentation
        env:
          TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          git commit -m "Automated documentation update by GitHub Actions"
          git push "https://$TOKEN@github.com/docsible/thermo-core.git" HEAD:main