test

.github/workflows/docs.yaml

@@ -0,0 +1,50 @@
+---
+name: Generate Docs
+
+on:
+  push:
+    branches: 
+      - main
+
+        #permissions:
+        #  contents: write
+
+jobs:
+  generate_docs:
+    #if: ${{ github.repository_owner == 'puppetlabs' }}
+    runs-on: ubuntu-latest
+    name: Generate Docs
+    env:
+      BUNDLE_WITH: "documentation"
+      BUNDLE_WITHOUT: "features packaging"
+    steps:
+      - name: Checkout current PR
+        uses: actions/checkout@v4
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.1
+          bundler-cache: true
+
+      - name: Install pandoc
+        run: |
+          sudo apt update
+          sudo apt install -y pandoc groff
+
+      - name: Generate references
+        id: generate-references
+        run: |
+          bundle exec rake references:all
+          git --no-pager diff --exit-code --ignore-matching-lines='This page was generated from the Puppet source' --ignore-matching-lines='built_from_commit:' man references || echo 'commit=true' >> "$GITHUB_OUTPUT" 
+
+      - name: Commit and Push
+        if: ${{ steps.generate-references.outputs.commit == 'true' }}
+        uses: EndBug/add-and-commit@v9
+        with:
+          author_name: GitHub Actions
+          author_email: actions@github.com
+          message: 'Update references'
+          add: 'man references'
+          push: false
+