Use ChangelogTags markers for June 10 changelog entries#5924
Conversation
Tag each of the three same-day releases individually with <ChangelogTags> and drop the now-redundant file-level tags frontmatter. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
🌿 Preview your docs: https://fern-preview-matlegault-changelog-tags-june-10.docs.buildwithfern.com/learn Here are the markdown pages you've updated: |
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
There was a problem hiding this comment.
🚩 Per-section tagging may indicate an intentional new pattern, but it's not supported
The PR replaces a single page-level tags: ["ai"] frontmatter with three different per-section <ChangelogTags> entries (ai, ai + configuration, ai + configuration + docs.yml). This suggests the author may have wanted per-heading tag granularity rather than a single set of tags for the whole changelog date entry. However, the Fern docs platform's changelog tagging system is documented as frontmatter-based (fern/products/docs/pages/navigation/changelogs.mdx:100-112 and fern/products/docs/pages/navigation/frontmatter.mdx:378-382), and no other entry in the repo uses per-section tags. If per-section tagging is a desired feature, it would need platform-level support and documentation updates — not just an ad-hoc component in one file.
Was this helpful? React with 👍 or 👎 to provide feedback.
| ## `fern-docs` agent skill | ||
| <ChangelogTags>ai</ChangelogTags> |
There was a problem hiding this comment.
🔴 YAML frontmatter with tags removed, violating AGENTS.md changelog rules
The AGENTS.md changelog rules explicitly require: "Always include tags in YAML frontmatter." This PR removes the entire YAML frontmatter block (---\ntags: ["ai"]\n---) and replaces it with inline <ChangelogTags> components. Every other changelog entry in the repo (e.g., fern/products/docs/pages/changelog/2026-06-12.mdx, 2026-06-13.mdx, 2026-05-28.mdx, etc.) uses YAML frontmatter for tags. The official docs at fern/products/docs/pages/navigation/changelogs.mdx:102 and fern/products/docs/pages/navigation/frontmatter.mdx:378-382 also document tags as a frontmatter field. Without frontmatter tags, the changelog filtering system will not recognize any tags for this entry.
Prompt for agents
The YAML frontmatter with tags was removed from this changelog entry. Per AGENTS.md rules and the pattern used by every other changelog entry in fern/products/docs/pages/changelog/, the file must begin with a YAML frontmatter block containing tags. The original file had tags: ["ai"] in frontmatter. Since the new version adds per-section tags (ai; ai+configuration; ai+configuration+docs.yml), you need to decide the appropriate set of tags for the frontmatter — likely the union of all section tags: ["ai", "configuration", "docs.yml"]. Restore the frontmatter block at the top of the file and remove the <ChangelogTags> components, which are not a recognized component pattern in this repo.
Was this helpful? React with 👍 or 👎 to provide feedback.
| --- | ||
|
|
||
| ## `fern-docs` agent skill | ||
| <ChangelogTags>ai</ChangelogTags> |
There was a problem hiding this comment.
🔴 <ChangelogTags> is not a recognized component and may fail to render
The <ChangelogTags> component is used three times in this file but does not appear anywhere else in the entire repository — no other changelog entry, no component definition, and no documentation references it. A grep across the whole repo confirms it exists only in this file (fern/products/docs/pages/changelog/2026-06-10.mdx). All other changelog entries use YAML frontmatter tags for tagging. Using an undefined MDX component will likely cause a build error or render as raw text, breaking the page.
Prompt for agents
Remove all three <ChangelogTags> lines (lines 2, 13, 20) and restore the YAML frontmatter block at the top of the file with the appropriate tags array. The standard pattern used by every other changelog file in fern/products/docs/pages/changelog/ is:
---
tags: ["ai", "configuration", "docs.yml"]
---
See any sibling changelog file (e.g. 2026-06-12.mdx or 2026-06-13.mdx) as a reference.
Was this helpful? React with 👍 or 👎 to provide feedback.
1 participant
The June 10 docs changelog has three same-day releases in one file, so they previously shared the file-level
tags: ["ai"]frontmatter. This adds a<ChangelogTags>marker under each H2 so every release carries its own tags on its card, the entry page, and the tag-filter list (changelog redesign, fern-platform #12385). Tags reuse the existing lowercase vocabulary:ai;ai, configuration; andai, configuration, docs.yml. The redundant file-leveltagsfrontmatter is removed since each section now includesai.