docs(changelog): migrate full history into Mintlify, rewrite 2026#623
docs(changelog): migrate full history into Mintlify, rewrite 2026#623jordanc-relevanceai wants to merge 11 commits into
Conversation
Adds 158 entries (March 2023 – May 2026) to a Mintlify <Update>-based changelog page, wires it as a sidebar anchor next to Community and Contact Support, and scopes the existing right-padding rule so it only applies when the right TOC sidebar is actually rendered (fixes wide-mode pages getting a dead-zone on the right). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Main /changelog now holds only 2026 entries (26) plus a CardGroup linking to /changelog/2025, /changelog/2024, /changelog/2023. Each year page mirrors the same format and cross-links to the others. Cuts the initial page from ~5700 lines to ~750 to reduce time-to-first-paint and image-load on the main page. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Trim marketing scaffolding ("you can now…", "transform", closing CTAs)
and rewrite every 2026 entry around what changed, why it matters, and
how to get to it. Cross-checked technical claims against the node API
repo and corrected three:
- Confluence Knowledge Sync: 5-minute polling, not real-time
- Claude Opus 4.6: both variants are 1M context; the "1M" entry exists
for pricing-tier separation
- AWS Bedrock Guardrails: clarify Relevance forwards a guardrail ARN;
the filters are configured AWS-side
Same-date entries are merged into a single <Update> with ## sub-headings
per feature, dropping 26 entries to 18. Enterprise-gated features use
<Note> callouts. Removed every "Other improvements / General fixes and
UI improvements" filler block.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a Relevance-AI-themed visual treatment to the changelog pages: indigo vertical rail in the left margin (continuous across all entries, fading in at the top of the first entry and out at the bottom of the last), an indigo dot per entry aligned with the date label, and a soft shadow on hero images. Scoped to pages whose data-page-title starts with "Changelog" so it applies to the main page and the three year archives. Also a casing sweep on the 2026 entries to capitalize the product nouns Agent, Tool, Workforce, Knowledge, and Chat (plus compound Phone Agent / Meeting Agent), per the docs style guide. Two small style.css fixes: - Scope the existing 20rem right padding on #content-area to only apply when the right TOC is actually rendered (otherwise wide-mode pages get a dead zone on the right). - Push Mintlify's anchor-link button further left so it doesn't sit underneath the timeline dot. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mirrors all 199 changelog images from cdn.relevanceai.com into images/changelog/ in the repo (~11MB) and rewrites the 206 image references across the four changelog files to local paths, so the docs no longer depend on the external CDN or the relevanceai.com changelog page staying up. Also converts the 10 video links (4 YouTube, 6 Wistia previously wrapped via cdn.embedly.com) into responsive 16:9 iframes using the same paddingTop: 56.25% wrapper pattern the repo uses for Supademo embeds, so they play inline instead of being blue text links. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Was 4px too high. Updated top: 2.25rem → 2.5rem so the dot's center sits at the date pill's vertical midpoint. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Documents the expansion of Relevance MCP access to users with the Member role in RBAC-enabled organizations, previously gated to Editor and above. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
jordanc-relevanceai
force-pushed
the
changelog-migration
branch
from
64a944f to
d328bc9
Compare
Derives alt text from each entry's heading so screenshots are accessible and the markdown-lint accessibility rule passes. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mintlify skipped the initial check while the PR was in draft. Empty commit to retrigger the external check now that the PR is open. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
🎯 Vibe checkReviewed: 4 MDX files + docs.json (4 MDX files with issues, 0 clean) Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. Scores are a single overall judgment about the whole PR. ✨ Overall vibe: The new 2026 entries in 🔧 Issues (32)Banned words —
Banned words —
British spellings —
British spellings —
Heading capitalization —
Emojis in content —
Broken link
Raw URLs (not using markdown link format) —
🏗️ Page structure (1)
🔋 Credit usage
Files read: |
🎯 Vibe checkReviewed: 5 files (3 with issues, 2 clean) Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. ✨ Overall vibe: The 2026 entries in 🔧 Issues (40)Banned words —
Banned words —
British spellings
Heading case violations —
Heading case —
Emojis in content
Typos and artifacts
Inconsistent product name
Bare/poor link text
Stale external links —
🧩 Component suggestions (1)
🏗️ Page structure (2)
✅ Clean files (2)
🔋 Credit usage
Files read: |
The top fade-in relied on `.update-container:first-child::before`, which matches on local dev but drops out on Mintlify production where the first child of the content area can differ. Move the gradient to a `::before` on `.mdx-content[data-page-title^="Changelog"]` so it renders regardless of child ordering. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
🎯 Vibe checkReviewed: 4 files (3 with issues, 1 clean) Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. ✨ Overall vibe: 🔧 Issues (25)Banned words —
Banned words —
British spelling —
British spelling —
Emoji usage —
Emoji usage —
Dead / outdated links —
Bare URL —
Marketing CTAs —
🧩 Component suggestions (3)
🏗️ Page structure (1)
✅ Clean files (1)
🔋 Credit usage
Files read: Non-doc files: |
…d tags Each accordion bullet is prefixed with a colored chip naming the surface the change relates to (MCP, Triggers, Tools, etc.) so the same surface gets the same colour across the whole changelog. Accordion body and summary fonts are shrunk so the supporting info doesn't overshadow the main entry body. Also widens the `main > div` cap to 100% on changelog pages so the page doesn't centre at 1400px and leave a dead zone on wide monitors. Includes placeholder example fixes / improvements / extras under both the May 13 and May 1 entries — replace with real items before publishing. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
🎯 Vibe checkReviewed: 4 MDX files (3 with issues, 1 clean) + docs.json + style.css Scores
Score key: 🟢 9–10, 🟡 6–8, 🔴 1–5. ✨ Overall vibe: The 2026 entries in 🔧 Issues (47)Banned words —
Banned words —
British spellings —
British spellings —
Emojis in documentation content
Heading capitalization —
Broken / wrong links
🏗️ Page structure (2)
✅ Clean files (1)
🔋 Credit usage
Files read: |
1 participant
Summary
Migrates the full Relevance AI changelog from relevanceai.com/changelog into the docs site as Mintlify
<Update>blocks, with a Relevance-AI-themed visual treatment./changelog(2026, 18 consolidated entries),/changelog/2025(107),/changelog/2024(17),/changelog/2023(8), with cross-links between years##sub-headings per featurenewspaper) next to Community and Contact Support, pointing at/changelogstyle.cssfix: the existing 20rem right padding on#content-areais now scoped via:has(div#content-side-layout)so it only kicks in when the right TOC is actually rendered (otherwise wide-mode pages got a dead zone on the right)Test plan
/changelogloads with 2026 entries + year cards at the bottom/changelog/2025,/2024,/2023all loadChangeloganchor (newspaper icon) navigates to/changelogin-place, not as an external link🤖 Generated with Claude Code