Skip to content

Docs: Standardize release notes titles and headers to "Release Notes" - #394

Open
kiran1287 wants to merge 1 commit into
mainfrom
fix_release_notes
Open

Docs: Standardize release notes titles and headers to "Release Notes"#394
kiran1287 wants to merge 1 commit into
mainfrom
fix_release_notes

Conversation

@kiran1287

@kiran1287 kiran1287 commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Renames all-releases.mdx to <version>-release.mdx per version line (v1.12.x, v1.13.x, v2.0.x-SNAPSHOT), consistent with the naming already used for older minor-version pages
  • Standardizes sidebar titles and in-page H1s from X.Y Release(s) to X.Y Release Notes, Old Releases to Older Release Notes, and Latest Release to Latest Release Notes for the pages tracking the current shipping version
  • Truncates the frontmatter title: field to end at OpenMetadata (dropping the redundant trailing X.Y Releases suffix)
  • Renames the "All Releases" nav group in docs.json to "All Release Notes" (3 occurrences)
  • Fixes a broken snippet import in v1.12.x/releases.mdx (1.2.14.mdx1.12.14.mdx) found during review — the typo'd path pointed at a file that doesn't exist
image

Test plan

  • docs.json validated as well-formed JSON
  • All snippet imports across every touched release page verified to resolve to real files
  • Spot-checked sidebar/H1 special-casing (only the two pages that actually import latest.mdx get "Latest Release Notes"; the frozen v1.12.x page correctly gets "1.12 Release Notes" instead)
  • Visual check in Mintlify preview once deployed

Renames all-releases.mdx to <version>-release.mdx per version line,
updates sidebar titles and in-page H1s from "X.Y Release(s)" to
"X.Y Release Notes" (and "Latest Release Notes" for the pages tracking
the current shipping version), truncates frontmatter titles to end at
"OpenMetadata", renames the "All Releases" nav group to "All Release
Notes", and fixes a broken snippet import in v1.12.x/releases.mdx.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 21, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
openmetadata 🟢 Ready View Preview Aug 21, 2026, 6:20 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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.

Docs: Inconsistent release notes titles, headers, and a broken snippet import

1 participant