Add Tool Maturity Model and Verified Tools sections with details - #39
Conversation
…ed guidelines and navigation updates
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
There was a problem hiding this comment.
🟢 Approval recommended
The changes are documentation-focused and internally consistent, with only a minor link-label mismatch noted in review comments.
Pull request overview
This PR expands the PPTB docs to clarify marketplace trust signals by introducing dedicated documentation for Verified vs Unverified tools and a “Tool Maturity Model” page for authors, and then wiring these pages into the site navigation and related doc flows.
Changes:
- Add new docs pages for Verified and Unverified Tools and the Tool Maturity Model.
- Update navigation and cross-links so users/authors can discover these pages from Tool Installation and Tool Development sections.
- Add a new
verified-badge.svgasset used in the new pages.
File summaries
| File | Description |
|---|---|
| src/components/Navigation.tsx | Adds nav entries to the new Verified Tools and Tool Maturity Model pages. |
| src/app/tool-installation/verified-tools/page.mdx | New page explaining Verified vs Unverified marketplace labels. |
| src/app/tool-installation/page.mdx | Adds cross-link and Next Steps navigation to the new Verified/Unverified page. |
| src/app/tool-development/publishing/page.mdx | Adds guidance and next-step links for requesting verification. |
| src/app/tool-development/maturity-model/page.mdx | New page describing verification request flow, reviewer checklist, and ongoing governance. |
| public/images/verified-badge.svg | Adds the Verified badge icon used by the new docs pages. |
Review details
- Files reviewed: 5/6 changed files
- Comments generated: 1
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟢 Approval recommended
Changes are limited to new documentation content, navigation wiring, and a new static image asset, with no apparent broken routes or inconsistent MDX patterns.
Review details
- Files reviewed: 5/6 changed files
- Comments generated: 0 new
- Review effort level: Lite
|
@copilot Add a note stating that verified tools will only be shown in the app for v1.2.6 and greater so people dont get confused when they dont see it in older version |
Co-authored-by: Power-Maverick <36135520+Power-Maverick@users.noreply.github.com>
There was a problem hiding this comment.
🟢 Approval recommended
Only minor spelling consistency nits were found; no functional or structural issues identified.
Review details
Suppressed comments (2)
Previously missed (1) — in code that hasn't changed since the last review.
src/app/tool-development/maturity-model/page.mdx:69
- Use US spelling to match the rest of the docs (e.g., other pages use “color”).
This issue also appears on line 95 of the same file.
- **Optional — Basic colour contrast:** Check text and interactive controls in both themes. This is not a strict WCAG audit, but obvious contrast failures are recorded.
src/app/tool-development/maturity-model/page.mdx:95
- Use US spelling to match the rest of the docs (e.g., other pages use “penalize” forms).
| Monthly active users (MAU) | 10 or more | Ongoing use, with a low threshold that does not unduly penalise newer tools. |
- Files reviewed: 5/6 changed files
- Comments generated: 0 new
- Review effort level: Lite
No description provided.