Skip to content

docs: document the blog changelog layout - #6731

Draft
devin-ai-integration[bot] wants to merge 2 commits into
mainfrom
devin/1787587342-blog-layout-docs
Draft

docs: document the blog changelog layout#6731
devin-ai-integration[bot] wants to merge 2 commits into
mainfrom
devin/1787587342-blog-layout-docs

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Documents the blog presentation for changelogs on the existing changelog page (no new page): layout: blog in a changelog's overview.mdx, the blog-layout: grid | list knob, the post metadata the layout reads (author registry, slug, excerpt fallbacks, thumbnail/image, draft/hidden), and the blog: navigation key as an alias for changelog:.

Also adds a one-clause pointer from the layout.changelog-layout ParamField in site settings (the site-wide setting still accepts only timeline and classicblog is per-changelog only), plus a Docs changelog entry.

Draft until the feature ships. The behavior documented here comes from three unmerged PRs:

Everything else on the page is unchanged: a blog is a changelog with different chrome, so dated entry filenames, reserved overview filenames, search, tag filtering, entry pages, and the rss/atom/json feeds all behave identically.

Link to Devin session: https://app.devin.ai/sessions/da27e5183b724ee0953e0cd3f4cbcd06

cadesark and others added 2 commits August 24, 2026 16:03
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>
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring



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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📝 [vale] <Microsoft.OxfordComma> reported by reviewdog 🐶
Use the Oxford comma in ', with search and tag filtering built in.'.

@github-actions

Copy link
Copy Markdown
Contributor

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