Skip to content

Checkout Prologue in the docs-site workflow - #51

Merged
einari merged 2 commits into
mainfrom
fix/checkout-prologue-in-docs-workflow
Jul 29, 2026
Merged

Checkout Prologue in the docs-site workflow#51
einari merged 2 commits into
mainfrom
fix/checkout-prologue-in-docs-workflow

Conversation

@einari

@einari einari commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Fixed

  • The documentation site build never checked out Cratis/Prologue as a sibling repo, so sync-content.mjs silently skipped it and /prologue/ was never built — breaking every internal link to it (the front page, the Cratis Stack page, and the CLI's cross-reference page). See the failing run: https://github.com/Cratis/Documentation/actions/runs/30431471372
  • A stale /arc/backend/tenancy/overview/ link on the "Why Cratis" page — the tenancy section's landing page is index.md, so its URL is /arc/backend/tenancy/ (no /overview/ segment). Pre-existing, unrelated to Prologue, found while validating the fix above.

Validated with a manual workflow_dispatch run on this branch (https://github.com/Cratis/Documentation/actions/runs/30432402059): all Prologue-related broken links are gone. The only remaining broken links are the two Arc aggregate-root links fixed in Cratis/Chronicle#3533 — once that merges, the build should be fully green.

The site build never checked out Cratis/Prologue as a sibling repo,
so sync-content.mjs silently skipped it and the /prologue/ page
never got built — breaking every link to it from the front page and
the CLI's cross-reference. Add the missing checkout step, matching
the pattern already used for Screenplay and the other self-contained
products.
@einari einari added the bug Something isn't working label Jul 29, 2026
The tenancy section's landing page is index.md, not overview.md, so
its URL is /arc/backend/tenancy/ — the /overview/ segment 404s and
was breaking the internal-links check.
@einari
einari merged commit 85f9b9b into main Jul 29, 2026
@einari
einari deleted the fix/checkout-prologue-in-docs-workflow branch July 29, 2026 08:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant