Import content updates to guidance from most recent document #24

	---
	name: build and publish

	on:
	pull_request:
	branches: [main]
	push:
	branches: [main]

	jobs:
	build:
	name: build
	runs-on: ubuntu-latest
	permissions:
	contents: write
	deployments: write
	steps:
	- name: checkout code
	uses: actions/checkout@v3
	with:
	fetch-depth: 0
	- name: setup python
	uses: actions/setup-python@v2
	with:
	python-version: '3.11'
	- name: setup poetry
	uses: Gr1N/setup-poetry@v8

	- name: install dependencies
	run: make build


	- name: upload pages artifact
	if: ${{ github.ref == 'refs/heads/main' }}
	uses: actions/upload-pages-artifact@v2
	with:
	path: site/

	go-semantic-release:
	if: ${{ github.ref == 'refs/heads/main' }}
	name: go-semantic-release
	needs: [build]
	runs-on: ubuntu-latest
	permissions:
	contents: write
	steps:
	- name: Run go-semantic-release
	uses: go-semantic-release/action@v1
	with:
	github-token: ${{ secrets.GITHUB_TOKEN }}
	changelog-generator-opt: emojis=true
	allow-initial-development-versions: true

	deploy:
	if: ${{ github.ref == 'refs/heads/main' }}
	needs: [build, go-semantic-release]
	runs-on: ubuntu-latest
	permissions:
	pages: write
	id-token: write
	environment:
	name: github-pages
	url: ${{ steps.deployment.outputs.page_url }}
	steps:
	- name: deploy site to gh pages
	id: deployment
	uses: actions/deploy-pages@v2

Provide feedback