Adds GH pages workflow and minor updates

[johnedquinn]

Relevant Issues

• This PR is copied from my older PR on the spec repo: Adds GH Pages Workflow partiql-spec#69

Motivation

The PartiQL Maintainers expressed the desire to make it easier to update the specification and have more tangible impact. As a mechanism for tackling these issues, I wanted to allow the tip-of-head specification to always be rendered.

Description

• This PR adds a GH Pages Workflow.
  • The head fork has GH Pages set up already. See the live site here.
  • On pushes to main, this will build using docker and place the HTML in the gh-pages branch.
• This PR also makes a few small changes:
  • We set versions explicitly to ensure that our builds are reproducible -- especially considering the fact that we don't maintain the Gemfile.lock. I ran into build issues because of this.
  • I modified how we perform releases. This matches how we perform releases for other projects such as PLK.
  • I removed the -it flag for running docker interactively -- this is because GH Actions doesn't allow this.
  • I updated how we retrieve the date of publication. I now do it by the last git commit date -- this ensures that when we checkout a tag, we can run it, and it gives us consistent dates.
  • I also updated the section links/anchors. See the documentation here. Now, we can send links to sections easily to each other.

Moving Forward

We will want to update how we perform releases. In my opinion, we need to update the revision numbers, tag, build on the tag, attach the generated HTML/PDF to the release assets, and update the development version.

Other Notes

• If approved, do NOT merge this for me. I need to enable GH Pages and create a dedicated branch before this workflow runs. I haven't done it yet as I wanted the maintainers' feedback before modifying the repository.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[am357]

Is it too involved to add a link to the latest released version (as adoc) at the top? if yes, maybe we can add a link to the list of all releases?

https://github.com/partiql/partiql-lang/releases

[johnedquinn]

Added!

[am357]

Thanks, and thank you for porting the previous releases!

[am357]

Thanks, and thank you for porting the previous releases!