Merge pull request #9497 from dotdash/tidy_recurse_docs #15

	---
	name: Generate References

	on:
	push:
	branches:
	- main

	permissions:
	contents: write

	jobs:
	generate_references:
	if: ${{ github.repository_owner == 'puppetlabs' }}
	runs-on: ubuntu-latest
	name: Generate References
	env:
	BUNDLE_WITH: "documentation"
	BUNDLE_WITHOUT: "features packaging"
	steps:
	- name: Checkout current PR
	uses: actions/checkout@v4
	with:
	token: ${{ secrets.RELEASE_BOT_GITHUB_TOKEN }}

	- name: Setup Ruby
	uses: ruby/setup-ruby@v1
	with:
	ruby-version: 3.2
	bundler-cache: true

	- name: Setup Pandoc
	uses: pandoc/actions/setup@d940685d5968400c91029147adbd612deb7696b0
	with:
	version: 3.1.8

	- 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@a94899bca583c204427a224a7af87c02f9b325d5
	with:
	author_name: GitHub Actions
	author_email: [email protected]
	message: 'Update references [no-promote]'
	add: 'man references'
	push: true

Provide feedback