From a5c6eedadca907166f95085c473e1933cdeedae1 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 23 Jan 2026 11:12:02 -0800 Subject: [PATCH 1/2] Update changelog.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- changelog.mdx | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/changelog.mdx b/changelog.mdx index 2cf6bfc87..18fa3c204 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -5,6 +5,28 @@ rss: true noindex: true --- + + + ## `skills.md` auto-generation + + Documentation sites now auto-generate a `skills.md` file that uses Claude to synthesize your API references, guides, and features into a comprehensive skills file that AI agents can consume. This replaces the previous `install.md` approach with richer capability documentation. If you have a custom `skills.md` file in your documentation repository, it takes priority over the auto-generated version. + + ## Audit logs for authentication events + + Login, logout, and signup events are now tracked in [audit logs](/dashboard/audit-logs) for enterprise compliance. This provides visibility into authentication activity across your documentation site. + + ## Markdown export via Accept header + + Documentation pages now serve raw markdown when the `Accept: text/markdown` header is sent, enabling better AI agent consumption of your content. + + ## Improvements + + - **Simplified authentication flow**: Streamlined login and signup UX with improved security that no longer reveals which authentication methods are available. + - **Hidden pages get noindex**: Pages hidden from navigation now automatically receive `noindex` meta tags for better SEO control. + - **Image captions in markdown**: Added markdown support for image captions. + + + ## `install.md` auto-generation From 83e8c96d14397d86e6fa4ae4a952837acbc889d4 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Fri, 23 Jan 2026 11:26:14 -0800 Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=92=85?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelog.mdx | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/changelog.mdx b/changelog.mdx index 18fa3c204..ca602f390 100644 --- a/changelog.mdx +++ b/changelog.mdx @@ -7,23 +7,23 @@ noindex: true - ## `skills.md` auto-generation + ## `skill.md` auto-generation - Documentation sites now auto-generate a `skills.md` file that uses Claude to synthesize your API references, guides, and features into a comprehensive skills file that AI agents can consume. This replaces the previous `install.md` approach with richer capability documentation. If you have a custom `skills.md` file in your documentation repository, it takes priority over the auto-generated version. + Documentation sites now auto-generate a `skill.md` file based on your API references, guides, and features to give AI agents a comprehensive skills file with context on how to help people use your product. `skill.md` replaces the `install.md` approach with more structured capabilities and wider adoption. If you have a custom `skills.md` file at the root of your documentation repository, it replaces the auto-generated version. See [skill.md](/ai/skillmd) for more information. ## Audit logs for authentication events - Login, logout, and signup events are now tracked in [audit logs](/dashboard/audit-logs) for enterprise compliance. This provides visibility into authentication activity across your documentation site. + Events are now tracked in [audit logs](/dashboard/audit-logs) for visibility and compliance. - ## Markdown export via Accept header + ## Markdown export for agents - Documentation pages now serve raw markdown when the `Accept: text/markdown` header is sent, enabling better AI agent consumption of your content. + Documentation pages now serve raw markdown when the `Accept: text/markdown` header is sent, which enables better AI agent consumption of content. ## Improvements - - **Simplified authentication flow**: Streamlined login and signup UX with improved security that no longer reveals which authentication methods are available. - - **Hidden pages get noindex**: Pages hidden from navigation now automatically receive `noindex` meta tags for better SEO control. - - **Image captions in markdown**: Added markdown support for image captions. + - Combined authentication, partial authentication, and personalization into a single authentication experience. See [Authentication setup](/deploy/authentication-setup) for more information. + - Hidden pages now automatically receive `noindex` meta tags for better SEO control. + - Added markdown support for image captions.