docs(discoverability): submission playbook + package.json metadata#215
Merged
Conversation
Step 7 of the open-source repo maintenance baseline initiative —
and the final one.
package.json:
- Add description (marketing-grade single-line pitch)
- Add 24 keywords for GitHub repo search and any future npm
publish (project-management, self-hosted, kanban, gantt,
multi-tenant, jira-alternative, asana-alternative,
monday-alternative, etc.)
- Add homepage, repository, bugs metadata fields
New file .claude/DISCOVERABILITY.md (internal, 464 lines):
- Audit of current GitHub repo metadata (description, 17 topics
already set ✓)
- 3 high-value topic additions with ready gh repo edit commands
- Submission targets ranked by ROI with ready-to-paste copy for
awesome-selfhosted, alternativeto.net, Product Hunt,
Hacker News (Show HN), Reddit (r/selfhosted, r/opensource,
r/coolgithubprojects), Dev.to + Hashnode launch outline,
LibHunt, opensource.builders, Indie Hackers
- SEO snippets for alianhub.com:
Core meta tags (title, description, OG, Twitter Cards)
schema.org SoftwareApplication JSON-LD markup
Sitemap & robots.txt reminders
- Tracking checklist with markdown checkboxes for every channel
- Maintenance cadence (once, per release, quarterly, annually)
- "What we deliberately skipped" with reasoning
.claude/REFERENCES.md: added DISCOVERABILITY.md to docs index.
Quality checks applied per code review:
- Meta description shortened from 215 to 140 chars (Google
SERP truncation fit)
- r/projectmanagement post replaced with SKIP recommendation
(high mod-removal risk; safer subreddits called out instead)
- HN tactics updated to 2026 reality (30+ upvotes/hour bar)
- og-image.png upgraded to BLOCKER with explicit creation guide
The playbook documents intent only — no external submissions or
repo-metadata changes are auto-executed. All gh repo edit commands
are ready to copy-paste after merge.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
joshishiv4
approved these changes
Jun 9, 2026
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
2 participants
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.
Summary
Step 7 of the open-source repo maintenance baseline initiative — the final one. 🎉
Wraps up the 7-point initiative (#207 license, #208 branching, #209 lint, #212 releases, #213 docker, #214 readme) with the discoverability layer: how AlianHub gets found by potential users.
Files changed (3)
package.jsondescription,keywords(24),homepage,repository,bugs. Helps GitHub repo search, future npm publish, license-scanning tools.claude/DISCOVERABILITY.md.claude/REFERENCES.mdWhat's in the playbook
24 keywords now in package.json
Quality fixes applied (self-review before push)
og-image.pngreferenced but doesn't exist on alianhub.comWhat this PR does NOT do (intentionally requires your action)
gh repo edit --add-topic self-hosted ...<head>og-image.pngassetCompatibility with other open PRs
package.jsonvs #207 (author/license at bottom)package.jsonvs #209 (devDeps at bottom).claude/REFERENCES.mdvs #207 (license row) + #208 (branching row) + #214 (... wait, #214 didn't touch this file)Test plan
gh repo edit --add-topic self-hosted --add-topic mongodb --add-topic jira-alternativeand verify the 3 new topics appear in GitHub repopackage.jsonparses cleanly:node -e "require('./package.json')"🎉 7-point initiative complete
7/7 PRs open against
staging. Ready to merge in any order, no conflicts beyond trivial line-adjacent edits.🤖 Generated with Claude Code