Add deploy-docsite workflow, Add build docsite to test workflow

[jem-davies]

YOU WILL NEED TO CHANGE A SETTING

In the github repo UI:

• click 'settings'
• left side bar, under 'code and automation' > Click 'Pages'
• Under heading 'Build and deployment' > dropdown 'Source' > Change to 'Github Actions'

[jem-davies]

Changes:

• Added a 'job' to .github/workflows/deploy-docsite.yml workflow, that will build the doc site when a PR is created.
• Added a new .github/workflows/deploy-docsite.yml that will redeploy the site on push to main.

I have made this repo with a change to the favicon to test - link to site.

[gregfurman]

Should this also happen on tag creation/release events?

[jem-davies]

I think that you could do either: on pushes to main OR a release event, I think if you did both you would be rebuilding the same site on a release event.

If we decide to only re-build the docsite on release then we can still trigger the build manually in the github UI for small fixes, i.e. favicon changes.

@richardartoul what do you reckon?

[gregfurman]

Yeah sure I see what you're saying. Perhaps just on main is fine since calling go install with latest will return HEAD of main in any case.