fix(catalog): point TechDocs at the default branch #67

Merged
martin merged 1 commit from fix/techdocs-ref-url into main 2026-11-22 10:48:52 +00:00
Owner

Summary

Point the recurring-events TechDocs source at an explicit default-branch tree URL.

Why

dir:. resolved against the repository-root backstage.io/source-location produces https://code.martials.no/Personal/recurring-events/, but Backstage's Gitea URL reader requires a branch ref. The TechDocs build failed with .../git/commits/undefined (404).

I verified readTree succeeds for https://code.martials.no/Personal/recurring-events/src/branch/main/ and returns the repository contents, including mkdocs.yml.

## Summary Point the recurring-events TechDocs source at an explicit default-branch tree URL. ## Why `dir:.` resolved against the repository-root `backstage.io/source-location` produces `https://code.martials.no/Personal/recurring-events/`, but Backstage's Gitea URL reader requires a branch ref. The TechDocs build failed with `.../git/commits/undefined` (404). I verified `readTree` succeeds for `https://code.martials.no/Personal/recurring-events/src/branch/main/` and returns the repository contents, including `mkdocs.yml`. ## Related - Personal/recurring-events#65 - Personal/backstage#25
fix(catalog): point TechDocs at the default branch
All checks were successful
ci/woodpecker/pr/pr-review Pipeline was successful
ab5606b2eb
Backstage's Gitea URL reader needs a branch ref to download the
repository tree, so a dir:. reference against the repo-root source
location cannot build the docs. Use an explicit tree URL instead.

Refs: Personal/recurring-events#65

Co-authored-by: OpenCode <opencode@anoma.ly>
martin merged commit e22a4d4184 into main 2026-11-22 10:48:52 +00:00
martin deleted branch fix/techdocs-ref-url 2026-11-22 10:48:52 +00:00
Sign in to join this conversation.
No description provided.