docs: add jira-axi and confluence-axi to community catalog - #112
Open
emilchristensen wants to merge 1 commit into
Open
docs: add jira-axi and confluence-axi to community catalog#112emilchristensen wants to merge 1 commit into
emilchristensen wants to merge 1 commit into
Conversation
This was referenced Jul 23, 2026
Open
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Intent
The developer wanted to add two tools, jira-axi and confluence-axi, to the community list in the AXI catalog (kunchenguid/axi upstream), following the repo's CONTRIBUTING.md exactly. They specified precise values for both entries (name, url, author, domain, description) using five fields in a fixed order, matching the existing community entries and preserving the file's ordering convention, with both URLs deep-linking into the emilchristensen/atlassian-axi monorepo package directories (to be verified against origin/main, falling back to the monorepo root if a path was wrong). They required regenerating docs via pnpm run docs:gen rather than hand-editing generated regions, so the PR would contain exactly three files (catalog.yaml, README.md, docs/index.html) without touching guarded release files, and validated with git diff --stat and pnpm run docs:check. Finally, they mandated committing with a specific message and shipping through the no-mistakes gate pointed at the captain's fork (never a hand-opened PR), driving the pipeline until a PR into kunchenguid/axi:main was open with green CI.
What Changed
community:entries tocatalog.yaml—jira-axi(domain: Issue tracking) andconfluence-axi(domain: Documentation), both authored byemilchristensenand deep-linking into theemilchristensen/atlassian-aximonorepo package directories.generated:...regions ofREADME.mdanddocs/index.htmlviapnpm run docs:gento reflect the two new catalog rows; generated regions were not hand-edited and no guarded release files were touched.Risk Assessment
✅ Low: Docs-only catalog addition where the two hand-edited catalog.yaml entries follow the established convention exactly, the generated README/HTML regions pass docs:check with zero drift, and both deep-link URLs were verified to resolve to real package directories on the target repo's main branch.
Testing
Ran the smallest relevant checks for a catalog-plus-generated-docs change: git diff --stat confirmed the 3-file scope with no guarded release files, pnpm run docs:check passed proving README.md and docs/index.html match catalog.yaml, and re-running pnpm run docs:gen produced no diff (generated, not hand-edited). Verified both deep-link URLs resolve on emilchristensen/atlassian-axi main via authenticated gh api (packages jira-axi/confluence-axi present) plus HTTP 200 on the clickable tree URLs against a 404 control. Captured reviewer-visible visual evidence by rendering docs/index.html in Chrome and screenshotting the community table, which shows both new rows (jira-axi / Issue tracking, confluence-axi / Documentation) with correct links, domains, and descriptions appended after glab-axi. All checks passed; worktree left clean with transient screenshots removed.
/var/folders/ch/2x1ggt6945jf7jjng1rmhyrh0000gn/T/no-mistakes-evidence/01KY82C40GGFK48H7FC2D5K951/community-table-new-entries.png)Evidence: docs:check result
Evidence: atlassian-axi packages on main (deep-link targets exist)
Pipeline
Updates from git push no-mistakes
✅ **intent** - passed
✅ No issues found.
✅ **Rebase** - passed
✅ No issues found.
✅ **Review** - passed
✅ No issues found.
✅ **Test** - passed
✅ No issues found.
git diff --stat d5aa171..25bd175- confirmed exactly 3 files (catalog.yaml, README.md, docs/index.html), no guarded release filespnpm install --frozen-lockfile- deps installed for docs scriptspnpm run docs:check- passed: 'generated regions match their sources' (README/index.html match catalog.yaml)pnpm run docs:genthengit status --porcelain- idempotent, zero diff vs committed generated filesgh api repos/emilchristensen/atlassian-axi/contents/packages?ref=main- confirmed jira-axi and confluence-axi package dirs exist on maincurl HTTP status on both tree URLs (200) vs a bogus path (404) - deep-links resolvechrome-devtools-axi opened rendered docs/index.html and screenshotted the community table showing both new entries✅ **Document** - passed
✅ No issues found.
✅ **Lint** - passed
✅ No issues found.
✅ **Push** - passed
✅ No issues found.