Skip to content

docs(changelog): migrate full history into Mintlify, rewrite 2026#623

Draft
jordanc-relevanceai wants to merge 6 commits into
mainfrom
changelog-migration
Draft

docs(changelog): migrate full history into Mintlify, rewrite 2026#623
jordanc-relevanceai wants to merge 6 commits into
mainfrom
changelog-migration

Conversation

@jordanc-relevanceai
Copy link
Copy Markdown
Collaborator

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.

  • 158 entries pulled from the sitemap (March 2023 → May 2026)
  • Split by year: /changelog (2026, 18 consolidated entries), /changelog/2025 (107), /changelog/2024 (17), /changelog/2023 (8), with cross-links between years
  • 2026 entries rewritten for clarity (less marketing, more facts), fact-checked against the relevance-api-node repo (3 substantive corrections — Confluence is 5-min polling not real-time; Claude Opus 4.6 is 1M context for both variants; AWS Bedrock Guardrails forwards the ARN, AWS handles the filters)
  • Same-date entries consolidated into a single Update with ## sub-headings per feature
  • Product nouns (Agent, Tool, Workforce, Knowledge, Chat, Phone Agent, Meeting Agent) capitalized
  • Visual: indigo vertical rail down the left of the entries with fade-in / fade-out at the ends, indigo dot per entry, soft shadow on hero images
  • Added "Changelog" anchor in the sidebar (icon: newspaper) next to Community and Contact Support, pointing at /changelog
  • One small style.css fix: the existing 20rem right padding on #content-area is 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

  • /changelog loads with 2026 entries + year cards at the bottom
  • /changelog/2025, /2024, /2023 all load
  • Year cards link to the right place; "Earlier changes" section appears at the bottom of every year page
  • Sidebar Changelog anchor (newspaper icon) navigates to /changelog in-place, not as an external link
  • Timeline rail is continuous between entries (no overlap brightness, no gaps); fades at the top of the first and bottom of the last
  • Hovering the date column reveals the Mintlify anchor-link icon without it being covered by the dot
  • No banned-words / lint regressions
  • Visual check in both light and dark mode

🤖 Generated with Claude Code

jordanc-relevanceai and others added 4 commits May 13, 2026 12:52
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>
@jordanc-relevanceai jordanc-relevanceai self-assigned this May 13, 2026
jordanc-relevanceai and others added 2 commits May 13, 2026 15:00
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant