/sitepreview

Repository for continuous documentation deployment. DO NOT COMMIT DIRECTLY TO THIS REPOSITORY UNLESS YOU KNOW WHAT YOU ARE DOING!

sitepreview

GitHub repo size Clean up

The gh-pages branch of this repository hosts the documentation from PRs of other repositories, so that we can preview the changes in PRs.

How it works

The preview-pr.yml workflow is triggered in PRs. It builds and pushes the documentation to the gh-pages branch of this repository, and creates/updates a comment with the preview URL link.

The URL scheme is:

https://seismo-learn.org/sitepreview/seismo-learn/<repository_name>/<PR_branch_name>

Cleanup

The cleanup workflow runs daily to:

  1. Delete the documentation if the corresponding branch was already deleted
  2. Generate an index file, which lists all documentations of current open PRs
  3. Squash all commits into one commit to avoid increasing repository size