Commit 3a87379
Create GitHub Actions workflow for deploying docs.
This allows+requires us to [replace each release's Javadoc directory with a Javadoc archive file](407e30a).
As noted in that commit, this saves a ton of time when switching branches: I'm now seeing ~3s instead of ~30s to switch to `gh-pages` and ~2s instead of ~7s to switch back to `master`. (It probably slows down downloading the entire repo's history, though, since the repo history now contains all the original files *plus* the archives that contain them all. I can fix that if I ever rewrite the whole history of `gh-pages`.)
I'd raised this possibility back in #7597 (comment).
To make this take effect, I'll need to update https://github.com/google/guava/settings/pages to use a Source of "GitHub Actions" instead of "Deploy from a branch." This matches what we already do for JSpecify.
I notice that it may be a little weird for our `master` branch to have a GitHub Actions setup that pushes to our `gh-pages` branch, which then has a GitHub Actions setup that deploys that branch. I suspect that it at least makes sense to have two separate actions, since we sometimes push to the `gh-pages` branch outside the context of a push to `main`—notably, when we perform a release.
(One thing that we could consider is the idea of merging `gh-pages` into `master`, presumably under a `docs` directory. But I think that's been possible forever, and we haven't done it. That's probably for the best, since it would make a shallow clone of `master` slow because of all the Javadoc.)
RELNOTES=n/a
PiperOrigin-RevId: 8514093471 parent 1a143d3 commit 3a87379
1 file changed
Lines changed: 56 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
0 commit comments