docs: document the blog changelog layout - #6731
Merged
Merged
Conversation
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Contributor
Author
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
|
||
|
|
||
| A changelog is a navigation entry that renders a dated timeline of entries. Point the `changelog` key at a folder and every Markdown file in it becomes an entry, grouped by date, with search and tag filtering built in. A changelog can go wherever a section can — as its own tab, or as an entry in your sidebar. | ||
| A changelog is a navigation entry that renders dated entries. Point the `changelog` key at a folder and every Markdown file in it becomes an entry, grouped by date, with search and tag filtering built in. A changelog can go wherever a section can — as its own tab, or as an entry in your sidebar. |
Contributor
There was a problem hiding this comment.
📝 [vale] <Microsoft.OxfordComma> reported by reviewdog 🐶
Use the Oxford comma in ', with search and tag filtering built in.'.
Contributor
|
🌿 Preview your docs: https://fern-preview-devin-1787587342-blog-layout-docs.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
…rdion Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
devalog
approved these changes
Aug 27, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documents the blog presentation for changelogs on the existing changelog page (no new page):
layout: blogin a changelog'soverview.mdx, theblog-layout: grid | listknob, the post frontmatter the layout reads, and theblog:navigation key as an alias forchangelog:.Post frontmatter (
title,slug,tags,description,thumbnail,author,draft) is a collapsed Post properties accordion ofParamFields, matching how frontmatter is documented on the page settings page. Theslugfield carries the main gotcha: entry slugs are full paths from the site base, so a post under a blog at/blogneedsslug: blog/my-post—slug: my-postpublishes outside the blog.The layout list now describes all three layouts on the same axis, including card granularity (
timeline= one card per top-level##heading,blog= one card per entry file).Feed details moved to the existing RSS feed section, where they apply to every changelog: the
.atomand.jsonfeeds, and the URL-segment allowlist (blog,posts,changelog,release-notes, …) thatfern checkenforces.Also adds a one-clause pointer from the
layout.changelog-layoutParamField in site settings (the site-wide setting still accepts onlytimelineandclassic—blogis per-changelog only), plus a Docs changelog entry.The feature is live in prod: fern-api/fern-platform#14055 (layout), fern-api/fern#17469 (
blog:alias) and fern-api/fern#17462 (feed slugs) are all merged and shipped in CLI 5.106.0.Link to Devin session: https://app.devin.ai/sessions/f63e6cf7ef1a46a1b165fa530aea5097
Open in Devin Desktop: https://app.devin.ai/desktop/session/f63e6cf7ef1a46a1b165fa530aea5097?variant=devin