Repository navigation
fix(deps): update dependencies #104
Workflow file for this run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: deploy-pages | |
| on: | |
| push: | |
| branches: [main] | |
| # Build on every pull request too, so a change to the layout, the content or | |
| # the Hugo version has to prove the site still builds before it lands. | |
| # Without this the workflow ran only on main, which meant a dependency bump | |
| # arrived with no signal at all -- its checks read "no checks", which is not | |
| # the same thing as green and must not be merged as if it were. | |
| pull_request: | |
| workflow_dispatch: | |
| # The build needs nothing beyond the source and the Pages configuration it | |
| # reads to compute the base URL. Publishing rights are granted to the deploy | |
| # job alone, below, so a pull request build cannot replace what is served. | |
| permissions: | |
| contents: read | |
| pages: read | |
| concurrency: | |
| group: pages | |
| cancel-in-progress: false | |
| jobs: | |
| build: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout | |
| uses: actions/checkout@v7 | |
| # Hugo resolves the landingkit module (hugo.toml [module]) with the go | |
| # command, at the version go.mod pins. | |
| - uses: actions/setup-go@v7 | |
| with: | |
| go-version-file: go.mod | |
| cache: false | |
| - name: Set up Hugo | |
| uses: peaceiris/actions-hugo@v3 | |
| with: | |
| hugo-version: "0.169.0" | |
| extended: true | |
| - name: Configure Pages | |
| id: pages | |
| uses: actions/configure-pages@v6 | |
| # This page states rbgo's ruby/spec total in the present tense in four | |
| # places, and on 2026-10-12 all of them said 22,488 while the gate's own | |
| # file summed to 23,511 — and two of them described the gate as a | |
| # "shrink-only floor of 22,475", a mechanism replaced by a per-file | |
| # baseline in ruby#739. A number and a mechanism, both stale, on the first | |
| # page anybody reads. | |
| # | |
| # The check sums the gate's own per-file baseline and compares it against | |
| # every present-tense claim here. It is the same binary the docs site | |
| # runs, consumed across repositories rather than copied: two readers of | |
| # one file cannot drift, where two transcriptions of one number already | |
| # had. A dated block ("measured <date>") is exempt, because a dated | |
| # measurement going stale is not an error. | |
| # | |
| # It runs BEFORE hugo so a wrong figure fails the build instead of being | |
| # published, and on pull requests as well as on main. An unreachable | |
| # baseline exits 2 and fails the step: an unreadable baseline finds no | |
| # disagreement either, and that silence would read as agreement. | |
| # | |
| # PINNED TO A TAG, not @main, and that is not tidiness. `@main` is not | |
| # "the current main": it is whatever the module proxy last cached for the | |
| # branch, and the lag is measurable -- | |
| # | |
| # $ go list -m github.com/go-embedded-ruby/docs@main | |
| # …v0.0.0-20261012071659-5a27ddae9f8d # 07:16:59 | |
| # $ gh api …/commits/main --jq .sha | |
| # 3384011416dc… # 07:25:48 | |
| # | |
| # The first version of this step used @main and failed on a branch whose | |
| # figures were right, because the tool it ran was nine minutes old and | |
| # could not yet see this page's phrasing. A tag resolves deterministically. | |
| # | |
| # ⛔ THE FLAG IS `--root` SINCE docs v0.4.0, where the tool moved to cobra. | |
| # `-root` is not a shorter spelling of it: pflag reads it as the cluster | |
| # -r -o -o -t and the step fails with "unknown shorthand flag: 'r' in | |
| # -root". The two are bumped TOGETHER for that reason -- a later bump that | |
| # changed only the version would have met this during an upgrade that had | |
| # nothing to do with it. | |
| # | |
| # Verified before bumping: the tool at that version reads THIS page's | |
| # phrasing, 4 current claims against the gate's 23511. The vocabulary | |
| # control still runs inside the tool on every invocation rather than only | |
| # under `go test`, precisely because this consumer never runs that | |
| # module's tests. | |
| # | |
| # ⛔ `--root .`, NOT `--root layouts`, since v0.5.0. This site states the | |
| # total in THREE places, and `layouts/` holds two of them. The third is | |
| # hugo.toml's `params.phases[].blurb` -- prose Hugo renders into the page | |
| # like any other -- and it read 23,481 for 26 days under a green check, | |
| # because neither the tool's `.md`/`.html` filter nor this root could | |
| # reach it. v0.5.0 reads .toml; widening the root is what puts the third | |
| # copy in the denominator. It checks 5 claims now, not 4. | |
| # | |
| # ⛔ v0.6.0 ALSO CHECKS THE VERSION THE TOTAL WAS COUNTED AT, which is why | |
| # this page now states it. `23,511 examples pass` is a count over a | |
| # POPULATION, and the population is selected by the Ruby version the | |
| # conformance shim resolves `ruby_version_is` guards at: at 3.4.1 every | |
| # example behind a `ruby_version_is "4.0"` guard is removed from the suite | |
| # before anything runs -- 61 block guards and 5 inline sites at that | |
| # boundary -- so the figure describes 3.4-shaped behaviour while this page | |
| # also says the project targets 4.0 semantics and names a 4.0.5 oracle. | |
| # All true, and together they read as a 4.0 result. | |
| # | |
| # The version is read from BOTH files in the interpreter repository that | |
| # spell it (`rubyVersion` and the shim's `CUR_VERSION`) and a disagreement | |
| # between them is a refusal, not a verdict on this page. The DIFFERENTIAL | |
| # ORACLE named here is a different claim, free to be newer, and is | |
| # deliberately not matched. | |
| # | |
| # Verified with the exact published command this lane runs, fetched | |
| # through the proxy: | |
| # | |
| # $ go run github.com/go-embedded-ruby/docs/tools/conformancefigure@v0.6.0 --root . | |
| # 5 total claim(s) and 2 version claim(s) checked against the gate's 23511 at Ruby 3.4.1 (two copies, agreeing) | |
| # | |
| # "two copies, agreeing" is the interpreter repository's state today; | |
| # go-embedded-ruby/ruby#845 collapses it to one and the same line will | |
| # then read "derived from RUBY_VERSION", with nothing here to change. | |
| - name: The stated conformance total, and the version it was counted at, match rbgo's gate | |
| run: go run github.com/go-embedded-ruby/docs/tools/conformancefigure@v0.6.0 --root . | |
| - name: Build landing page | |
| run: hugo --minify --baseURL "${{ steps.pages.outputs.base_url }}/" | |
| - name: Upload artifact | |
| uses: actions/upload-pages-artifact@v5 | |
| with: | |
| path: public | |
| deploy: | |
| # Only main publishes. A pull request stops after build above: it has built | |
| # the site, which is the whole point of the gate, and it has no business | |
| # replacing what is served. | |
| if: github.event_name == 'push' || github.event_name == 'workflow_dispatch' | |
| needs: build | |
| runs-on: ubuntu-latest | |
| permissions: | |
| contents: read | |
| pages: write | |
| id-token: write | |
| environment: | |
| name: github-pages | |
| url: ${{ steps.deployment.outputs.page_url }} | |
| steps: | |
| - name: Deploy to GitHub Pages | |
| id: deployment | |
| uses: actions/deploy-pages@v5 |