Uh oh!
There was an error while loading. Please reload this page.
Wire agent-rules, ver, and issues-browser into docs hub - #1
Conversation
…ools hub. Co-authored-by: Cursor <cursoragent@cursor.com>
Bugbot is not enabled for your account, so this pull request was not reviewed. Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs. |
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Documentation review — PR #1
Verdict: The wiring is correct and follows established portal-stub patterns. Component names in remote docs/antora.yml files (agent-rules, ver, issues-browser) match the playbook URLs and portal xrefs. Production build (pnpm run build:online) completes successfully with the new content sources.
What this PR covers well
- All three playbooks updated consistently (production, local, testing)
- Portal stubs with description, component xref, repository link, and highlights
- Sensible rename handling:
issue-tracker→ redirect stub, newissues-browserpage with NOTE - Tools index and sidebar nav updated
Gaps addressed in follow-up PR
A companion PR adds documentation that should ship alongside this wiring:
- where-docs-live.adoc — Still referenced
issue-tracker; now documents issues-browser, agent-rules, and ver - activity-log.adoc — No entry for this integration
- Changelog — No changelog structure existed; index + detail pages backfilled
- README.adoc — Missing Docs | Dev-Centr and Deploy CI badges
Optional follow-ups (not blocking)
- Home portal cards —
index.adocdoes not yet feature Agent Rules, Ver, or Issues Browser (FixNow and Ibex have cards). Consider adding cards if these are priority surfaced tools. - xref style — New stubs use
xref:agent-rules::index.adoc; FixNow usesxref:fixnow-dev:ROOT:index.adoc. Both resolve; consider standardizing on the explicitROOTform for consistency. - AI search extension — Org playbook has Lunr but not
@antora-supplemental/antora-ai-help-extensionyet (org-wide, tracked separately).
Sent by Cursor Automation: Generate docs
| * CLI, DlangUI GUI, daemon, and tray client | ||
| * SDL forge profiles (GitHub implemented; GitLab stub) | ||
| NOTE: Formerly named `issue-tracker`. Prefer `issues-browser` for new links. |
There was a problem hiding this comment.
Good rename note. The redirect stub at issue-tracker.adoc plus this NOTE gives bookmark/link migration a clear path.
| branches: HEAD | ||
| start_path: docs | ||
| - url: https://github.com/dev-centr/issue-tracker.git | ||
| - url: https://github.com/dev-centr/issues-browser.git |
There was a problem hiding this comment.
Verified against remote docs/antora.yml: component name is issues-browser (not issue-tracker). Playbook URL and portal xref align.
| == Highlights | ||
| * Shared `RULES.md` + `general/` + `profiles/` for end-user agents | ||
| * Separate from product automation (`devcentr-agent-rules`) |
There was a problem hiding this comment.
The distinction between end-user agent rules and devcentr-agent-rules product automation is valuable context — consider mirroring this in the component repo's intro if not already there.
Summary