Add AI Hub navigation, Support page, and Applied AI Blog - #1912
Add AI Hub navigation, Support page, and Applied AI Blog#1912annieporter02 wants to merge 5 commits into
Conversation
Converts src/pages/support.tsx into docs/support/index.md so it follows the standard docs frontmatter/sidebar conventions and gets a real sidebar entry, instead of being an orphaned standalone page. Updates the Support nav tab to point at the new /docs/support route and adds a redirect from the old /support URL. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
docs/ai/{snowplow-assistant,snowplow-mcp-server,cli-mcp-server,signals,
documentation-llms-txt,documentation-markdown} were thin stub pages
duplicating fuller content already at docs/llms-support/ and
docs/signals/. Repoints the AI Hub cards, migration guide links, and
the Skills Marketplace link at the canonical pages/anchors, and fixes
the redirects.js entries that pointed the real pages back at the
stubs we just deleted.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Adds a BlogPostCard component (icon banner, category pill, title, author initials avatar, and date) and uses it for the AI Blog page's first two posts, part 1 and 2 of the Measuring first-party AI agents series. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
Thanks for your pull request. Is this your first contribution to a Snowplow open source project? Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA). 📝 Please visit https://docs.snowplowanalytics.com/docs/contributing/contributor-license-agreement/ to learn more and sign. Once you've signed, please reply here (e.g. I signed it!) and we'll verify. Thanks. |
Missing SEO metadataThe following markdown files are missing required metadata fields:
Required fieldsThe file metadata is important for SEO and marketing. All markdown files, except for those with filenames starting with
Please add the missing metadata. |
Greptile SummaryThe PR establishes dedicated AI and Support documentation areas, adds an interactive skills marketplace and Applied AI cards, and updates navigation, sidebar transformation, redirects, and Docusaurus dependencies.
Confidence Score: 4/5The PR appears safe to merge after addressing two non-blocking UI concerns involving menu accessibility and unintended shared LinkCard styling. The new routes and redirects have no established blocking failure, while the remaining findings are an unresolved AI-menu label and unconditional presentation changes to a shared card component. Files Needing Attention: src/components/tutorials/TutorialTabs.tsx, src/components/CardGrid.tsx
|
| Filename | Overview |
|---|---|
| src/components/tutorials/TutorialTabs.tsx | Adds functional AI dropdown and Support navigation on desktop and mobile, but both menus have an unresolved ARIA label reference. |
| src/components/CardGrid.tsx | Adds centered cards but also applies the new Support-oriented gradient and smaller typography globally to all LinkCard consumers. |
| sidebars.js | Expands link-item normalization and section-link construction without a concrete current failure identified. |
| worker/redirects.js | Retargets legacy MCP routes and adds canonical documentation and Support redirects with no concrete redirect failure established. |
| src/components/skills/SkillsMarketplace.tsx | Adds category filtering, installation guidance, and repository links for the skills marketplace. |
| docs/ai/index.md | Adds the AI Hub landing page with cards targeting canonical AI documentation sections. |
Flowchart
%%{init: {'theme': 'neutral'}}%%
flowchart LR
Nav[Desktop and mobile navigation] --> AI[AI Hub]
Nav --> Support[Support docs]
AI --> Skills[Skills Marketplace]
AI --> Blog[Applied AI Blog]
AI --> Canonical[Canonical MCP, Assistant, and Signals docs]
Legacy[Legacy URLs] --> Redirects[Worker redirects]
Redirects --> Support
Redirects --> Canonical
Reviews (1): Last reviewed commit: "Redesign Applied AI Blog cards to match ..." | Re-trigger Greptile
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
| anchorEl={menuAnchor} | ||
| open={Boolean(menuAnchor)} | ||
| onClose={handleMenuClose} | ||
| MenuListProps={{ 'aria-labelledby': 'ai-tab-menu' }} |
There was a problem hiding this comment.
Both AI menus set aria-labelledby="ai-tab-menu", but neither AI tab declares that ID, so assistive technology cannot resolve the intended accessible label and may announce the menu without a meaningful name.
| to={href} | ||
| className="link-card block rounded-lg bg-card p-6 transition-all duration-200 hover:shadow-md" | ||
| style={{ border: '1px solid hsl(var(--border))' }} | ||
| className={`link-card block rounded-lg p-6 transition-all duration-200 hover:shadow-md ${centered ? 'text-center' : ''}`} | ||
| style={{ | ||
| border: '1px solid hsl(var(--border))', | ||
| background: 'linear-gradient(135deg, rgba(111, 76, 255, 0.12) 0%, rgba(111, 76, 255, 0.04) 100%)', | ||
| }} | ||
| > | ||
| <p className="mb-3 text-xl font-semibold text-foreground">{title}</p> | ||
| <p className="text-base text-muted-foreground mb-0">{description}</p> | ||
| <p className="mb-3 text-lg font-semibold text-foreground">{title}</p> |
There was a problem hiding this comment.
The gradient and smaller typography are applied unconditionally to the shared LinkCard, so existing card grids across the documentation also receive the Support page redesign. Scope these presentation changes to the new variant so unrelated cards remain unaffected.
Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!
|
I signed it
…On Tue, Aug 18, 2026 at 10:43 AM Snowplow CLA bot ***@***.***> wrote:
*snowplowcla* left a comment (snowplow/documentation#1912)
<#1912 (comment)>
Thanks for your pull request. Is this your first contribution to a
Snowplow open source project? Before we can look at your pull request,
you'll need to sign a Contributor License Agreement (CLA).
📝 Please visit
https://docs.snowplowanalytics.com/docs/contributing/contributor-license-agreement/
to learn more and sign.
Once you've signed, please reply here (e.g. I signed it!) and we'll
verify. Thanks.
—
Reply to this email directly, view it on GitHub
<#1912?email_source=notifications&email_token=BRSFEXY6CBNFA74FJYF7F4D5KRTQVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMZSHE4DANRZGYYKM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-5329806960>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/BRSFEX2YPWQB6VHPMLCMGM35KRTQVAVCNFSNUABFKJSXA33TNF2G64TZHM2TENBZGQ3DENRQHNEXG43VMU5TKMJYGMYDMNBXGM42C5QC>
.
Triage notifications, keep track of coding agent tasks and review pull
requests on the go with GitHub Mobile for iOS
<https://github.com/notifications/mobile/ios/BRSFEX4EF3XLGB6ZNBUKBT35KRTQVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMZSHE4DANRZGYYKM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG>
and Android
<https://github.com/notifications/mobile/android/BRSFEX3NT6IG72JL7IVEB5D5KRTQVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTKMZSHE4DANRZGYYKM4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>.
Download it today!
You are receiving this because you authored the thread.Message ID:
***@***.***>
|
|
Confirmed! annieporter02 has signed the Contributor License Agreement. Thanks so much. |
Documentation style reviewReviewed against All external URLs touched by this PR resolve (snowplow.io blog posts, 1. Internal links converted away from
|
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
documentation | 8ebd1eb | Commit Preview URL Branch Preview URL |
Aug 18 2026, 03:22 PM |
- Revert 3 internal Markdown links to the required /index.md form
(docs/event-studio/programmatic-management, migration-guides/adobe-analytics,
migration-guides/mixpanel) — LinkCard href props are unaffected, they
already matched the existing convention.
- Drop "Our"/"we"/"our" language from the AI hub title and blog intro;
Snowplow is referred to in third person per the style guide.
- Sentence-case the AI Blog, MCP Resources, and Skills Marketplace page
titles/sidebar labels, and match the AI hub card titles to their
target page titles so navigation reads consistently.
- Fill in missing frontmatter (keywords, sidebar_label, date, quoted
values) on the blog, skills, and mcp-resources pages.
- Replace "&" with "and" in skill category names, hyphenate "back-end",
and remove marketing-voice phrasing ("Discover", "Explore how", "Find
out how") from AI hub card descriptions in favor of direct statements.
- Fix Skills Marketplace copy: use Docusaurus Link instead of a raw
external-style <a> tag for an internal link, cut a filler sentence,
and restructure a comma-heavy sentence with em dashes.
- Remove the docs/ai/mcp-resources stub page — it promised guides and
examples it didn't have, and wasn't linked from any AI hub card.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
Claude (@claude) can you review against the docs style guide again? |
Docs style reviewReviewed against
|
2 participants
What changed?
/docs/ai/) with cards linking to Snowplow Assistant, Snowplow MCP Server, CLI MCP Server, Signals, the Skills Marketplace, and the Applied AI Blog.docs/ai/(snowplow-assistant,snowplow-mcp-server,cli-mcp-server,signals,documentation-llms-txt,documentation-markdown) that duplicated fuller content already published atdocs/llms-support/*anddocs/signals/, and pointed the AI Hub cards, a few migration guide links, and the Skills Marketplace component at the canonical pages/anchors instead. Fixed theworker/redirects.jsentries that had pointed the real pages back at those now-deleted stubs.src/pages/support.tsxReact page intodocs/support/index.md, so it follows the standard docs frontmatter conventions and gets a real sidebar entry instead of being an orphaned standalone route. Added a redirect from the old/support/URL.src/components/skills/)./docs/ai/blog/) with a newBlogPostCardcomponent (icon banner, category tag, title, author avatar, date) matching the style of snowplow.io/blog, and published the first two posts in the "Measuring first-party AI agents" series.Why?
Establishes a dedicated AI section of the docs site with consistent navigation and no duplicated content, and gives Support and the AI blog proper homes in the docs information architecture instead of ad hoc standalone pages.
Reviewer guidance
docs/llms-support/*anddocs/signals/pages rather than thinnerdocs/ai/*versions that existed earlier in this branch — those were deleted as duplicates, along with the redirects that pointed at them./docs/llms-support/rather than separate pages, for the same reason.BlogPostCard(src/components/blog/BlogPostCard.tsx) is a new, separate component from the existingLinkCard/CardGrid, so other cards across the site are unaffected.AI reviews
Claude will automatically review this PR against the docs style guide.
If you have questions or want it to look again at something specific, tag
@claudein a comment.