Deliver TechDocs for one real Forgejo repository #25
Labels
No labels
automerge
bug
dependencies
duplicate
help wanted
invalid
lang
rust
migrations
opencode
question
security
type
documentation
type
enhancement
type
maintenance
type
refactor
vulnerability
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Depends on
#65 Add a TechDocs site for recurring-events
Personal/recurring-events
#28 Support repository-owned catalog metadata
Personal/backstage
Reference
Personal/backstage#25
Loading…
Reference in a new issue
No description provided.
Delete branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Goal
Prove the complete documentation workflow in one real repository before broad rollout.
Acceptance criteria
Depends on
Phase
2 — Useful developer workflows
Completion evidence
Progress
Personal/recurring-eventsas the pilot. The docs source/build and catalog annotation are merged in recurring-events#66, with the Gitea branch-ref correction in #67; the repository-local issue #65 is closed.nix develop --command just docsandnix fmtpassed.recurring eventsreturned 12 results.bun run tsc,bun run prettier:check, andbun run test:e2e(7/7 passed). PR review CI passed; application-checks CI was still pending when this update was written.Decisions
.../src/branch/main/; a rootsource-locationplusdir:.fails because the Gitea reader cannot infer the branch. The E2E fixture uses localdir:.and mocks generated TechDocs responses, keeping it independent of Forgejo and Docker.Remaining
Result
nix develop --command just docs; the pilot's TechDocs pages and metadata rendered through Backstage, and search returned 12 TechDocs results forrecurring events.bun run tsc,bun run prettier:check, and controlled E2E tests (7/7). Woodpecker application checks and PR review both succeeded for #61.All acceptance criteria are satisfied. Closing #25.