]> git.evergreen-ils.org Git - working/Evergreen.git/commit
LP1903476: Use Github Actions to build antora documentation
authorJane Sandberg <sandbej@linnbenton.edu>
Wed, 27 Oct 2021 17:16:30 +0000 (10:16 -0700)
committerJason Boyer <JBoyer@equinoxOLI.org>
Wed, 12 Jan 2022 12:10:49 +0000 (07:10 -0500)
commitc9c1041c4d20dc8319c92ba461ac43543513e073
tree5de05d8755076367e8369a378ebd53c4ab024115
parente79df5dd87a895a61d15fdc569d904d2642091a8
LP1903476: Use Github Actions to build antora documentation

This allows documenters to submit a pull request and get a
preview version where they can view their changes.  The goal
is to provide quick feedback to documenters on whether their
changes build correctly and appear as desired, without them
having to have a full docs building setup locally.

To test:
1. Use the Github Web site to fork the Evergreen repository.
2. Take the .github/workflows/docs.yml file from this commit.
Add it to any branch of your fork of the Evergreen repository.
3. Click on the Actions tab of your fork in the Github Web
site.
4. Click on the most recent run (at the top of the list).
5. When the build process is done (should take 3-4 minutes),
download and unzip the artifact that appears at the bottom of
the screen.  Open index.html in your browser.  Confirm that
the docs built properly.
6. On the same branch, make some changes to the documentation
in the docs/modules directory.
7. Repeat steps 3-5.  Confirm that your changes are reflected
in the new artifact.

Signed-off-by: Jane Sandberg <sandbej@linnbenton.edu>
Signed-off-by: Jason Boyer <JBoyer@equinoxOLI.org>
.github/workflows/docs.yml [new file with mode: 0644]