Skip to content

Update gh-pages GitHub Action to use shared version in .github repo - #344

Merged
stumbo merged 7 commits into
mainfrom
bs30_staging_site
Aug 19, 2026
Merged

Update gh-pages GitHub Action to use shared version in .github repo#344
stumbo merged 7 commits into
mainfrom
bs30_staging_site

Conversation

@stumbo

@stumbo stumbo commented Aug 11, 2026

Copy link
Copy Markdown
Member

Updates the Interlisp.github.io repository to build staging sites per PR and deploy them at https://Interlisp.github.io/Interlisp.staging/pr-nn/

  • Common build workflows use by both this site and Interlisp.staging reside in a separate workflow repository, shared-workflows
  • On creation or update of a PR, a GitHub Action is spawned to build the staging site and annotate the PR with the path to it.
  • On closing or merging the staging site is torn down. There is also a separate GHA the runs nightly looking for orphan staging sites and removes them. I'm not sure if this is really important, but I wanted to ensure we didn't end up with a collection of unused and outdated staged sites.
  • The current design builds a faithful recreation of the site as it will look once the PR is merged. This includes all the static documentation pages. We may want to prune these out in the future if the amount of space being used to stage PRs becomes unwieldy.
  • A staging site was created for this PR, illustrating end to end functionality.

stumbo added 6 commits August 10, 2026 23:52
This commit points to the development branch and not the master branch.
Environment variables are not available as parameters for a shared
workflow - how about as a parameter availabe from a previously run job?
Update README.md to reflect current design.
…main

- gh-pages.yml: add preview job triggering deploy-preview.yml in
  Interlisp.staging for every PR (guarded to skip fork PRs and when
  STAGING_APP_ID is unset); pin build-site.yml@main
- preview-cleanup.yml: on PR close, dispatch remove-preview.yml in
  Interlisp.staging to delete the /pr-<N>/ subdirectory
- .gitignore: ignore .coverage, tests/__pycache__/, and _vendor/
Automates creation of staging site per PR allowing preview of
changes.  Upon merge or close of PR, staging site is torn down.
@interlisp-staging-bot

Copy link
Copy Markdown

Staging preview for this pull request is available at https://interlisp.github.io/Interlisp.staging/pr-344/

@stumbo stumbo self-assigned this Aug 18, 2026
@stumbo
stumbo marked this pull request as ready for review August 18, 2026 22:42

@hjellinek hjellinek left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems to work fine.

@stumbo
stumbo requested a review from MattHeffron August 18, 2026 22:52

@pamoroso pamoroso left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks good.

Provides an indepth discussion of the design and operation of the
staging site workflows.
@interlisp-staging-bot

Copy link
Copy Markdown

Staging preview for this pull request is available at https://interlisp.github.io/Interlisp.staging/pr-344/

@stumbo
stumbo merged commit 2a5d74c into main Aug 19, 2026
5 checks passed
@stumbo
stumbo deleted the bs30_staging_site branch August 19, 2026 17:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants