Document changelog timeline redesign, per-entry tags, and search#5932
Document changelog timeline redesign, per-entry tags, and search#5932fern-api[bot] wants to merge 5 commits into
Conversation
- Update changelogs.mdx with timeline layout, full-text search, and ChangelogTags per-entry tagging documentation - Add Search and filtering section covering ?q= search and clickable tags - Update configuration overview card description - Fix broken component library link Co-Authored-By: bot_apk <apk@cognition.ai>
|
|
||
| When a heading has a `<ChangelogTags>` marker, those tags replace the frontmatter tags for that entry's card on the timeline. Headings without a marker inherit the frontmatter tags as usual. | ||
|
|
||
| Use specific, descriptive tags that readers would naturally search for. Consider tagging by feature type, product area, release stage, affected platform, or user impact. |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Adverbs] Remove 'naturally' if it's not important to the meaning of the statement.
|
|
||
| The changelog page includes a search bar and tag filter at the top of the timeline. Both are available to readers without any additional configuration. | ||
|
|
||
| - **Full-text search** — Readers can type keywords into the search bar to find entries across the entire changelog, not just the entries visible on the current page. The query syncs to the `?q=` URL parameter, so search results are shareable as links. |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Hedges] Avoid hedge words and filler like 'just'. Prefer direct statements.
|
🌿 Preview your docs: https://fern-preview-devin-1782247122-changelog-docs.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: bot_apk <apk@cognition.ai>
|
Requested by: devin.logan |
Co-Authored-By: bot_apk <apk@cognition.ai>
| <AccordionGroup> | ||
| <Accordion title="Per-file tags (frontmatter)"> | ||
|
|
||
| Add a `tags` array in the file's YAML frontmatter to tag all of the entries for that date: |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[Microsoft.Wordiness] Consider using 'all' instead of 'all of'.
| Search queries sync to the `?q=` URL parameter, so a search result is shareable as a link. | ||
|
|
||
| ### RSS feed | ||
| ## RSS feed |
There was a problem hiding this comment.
📝 [vale] reported by reviewdog 🐶
[FernStyles.Headings] 'RSS feed' should use sentence-style capitalization.
Summary
Documents the changelog page redesign from fern-platform#12385, which replaces the full-height inline entry layout with a compact, date-grouped timeline of cards with built-in search and tag filtering.
Key documentation additions to
changelogs.mdx:<ChangelogTags>per-entry tagging — New "Per-entry tags" subsection documenting how authors can tag individual headings within a single changelog file using<ChangelogTags>tag1, tag2</ChangelogTags>or<ChangelogTags tags={["tag1", "tag2"]} />## Search and filteringsection covering full-text search (?q=param) and clickable tag badges that link back to the filtered timeline/learn/docs/content/...→/learn/docs/writing-content/...)Also includes:
2026-06-23.mdx) announcing the timeline redesign and per-entry tagsRequested by: Fern Support