Docs

cleanup(insights): General cleanup around the insight resource to simplify for future enhancements #4

	# Auto-generate documentation and commit changes to PRs
	name: Docs

	on:
	pull_request:
	branches:
	- main

	permissions:
	contents: write
	pull-requests: write

	jobs:
	generate:
	name: Generate and commit
	runs-on: ubuntu-latest
	# Only run on PRs from the same repo (not forks) to allow pushing
	if: github.event.pull_request.head.repo.full_name == github.repository
	steps:
	- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
	with:
	ref: ${{ github.head_ref }}
	token: ${{ secrets.GITHUB_TOKEN }}

	- uses: actions/setup-go@4dc6199c7b1a012772edbd06daecab0f50c9053c # v6.1.0
	with:
	go-version-file: 'go.mod'
	cache: true

	- uses: hashicorp/setup-terraform@b9cd54a3c349d3f38e8881555d616ced269862dd # v3.1.2
	with:
	terraform_wrapper: false

	- name: Run make generate
	run: make generate

	- name: Check for changes
	id: changes
	run: \|
	if [[ -n "$(git status --porcelain)" ]]; then
	echo "has_changes=true" >> $GITHUB_OUTPUT
	else
	echo "has_changes=false" >> $GITHUB_OUTPUT
	fi

	- name: Commit and push changes
	if: steps.changes.outputs.has_changes == 'true'
	run: \|
	git config --local user.name "github-actions[bot]"
	git config --local user.email "github-actions[bot]@users.noreply.github.com"
	git add -A
	git commit -m "chore: auto-generate documentation

	This commit was automatically generated by the CI pipeline.
	Run 'make generate' locally to regenerate documentation."
	git push

Provide feedback