AGENTS.md — What's New folder guide
See this release's improvements and features, or subscribe to our RSS feed.
This folder contains the product changelog (release notes) for the Talon.One documentation site. Each file represents a specific release.
File naming
| Pattern | When to use |
|---|---|
YYYY-MM-DD.md (exact date) | Specific/weekly releases with a version tag |
Frontmatter format
---
title: April 8, 2026 # Exact date for specific releases
tags: ['26.07'] # Release version tag
---
Content structure
All files wrap their content between <!-- vale off --> and <!-- vale on--> to disable the Vale linter.
They might contain the following elements:
- Optional
<NewFeature>components for major features (placed before the details block). - The details summary reads More updates. You can use this page as an example.
- You can generate an empty page with the
Create a release notesnippet. - You can generate new feature entries with the
insert new featuresnippet.
<!-- vale off -->
{
<details open>
<summary><strong>Updates</strong></summary>
<div>
<div>
<strong>Enhancements:</strong>
<ul>
<li>Feature area: Description with <a href="/docs/...">link</a>.</li>
</ul>
</div>
</div>
<div>
<strong>Bug fixes:</strong>
<ul>
<li>Feature area: Description with <a href="/docs/...">link</a>.</li>
</ul>
</div>
</details>
}
<!-- vale on-->
Key conventions
- Links: Always use root-relative paths (
/docs/product/...,/integration-api#...,/management-api#...). Never use absolute URLs. <NewFeature>tag attribute: Choose a value from this list:Loyalty programs,Rule Builder,Applications,Campaigns,Integration API,Management API,Roles & permissions,Account,Infrastructure,Documentation.- Bug fix vs Enhancement: All changes go under one of these two sections. No other section types exist.
{...}wrapper: The<details>block is always wrapped in{...}(Docusaurus MDX expression syntax).