From 2c307ac5d54dd424b62aacbd63e9c7dfd426fe1f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Canouil?=
 <8896044+mcanouil@users.noreply.github.com>
Date: Sat, 1 Aug 2026 20:37:54 +0200
Subject: [PATCH] docs: document filters with the bare extension name

The long `path`/`at` form overrides the entry point of every filter an
extension contributes, so the documented `at: pre-quarto` also moved
`typst-title-fix.lua` off `post-quarto`. The manifest already carries
both entry points, so naming the extension alone is enough.
---
 CHANGELOG.md       | 4 ++++
 docs/index.qmd     | 6 ++----
 docs/reference.qmd | 3 +--
 example.qmd        | 3 +--
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6082327..a7c42ba 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+### Documentation
+
+- docs: Document the filter as `filters:` with the bare `code-window` name. The long form `path`/`at` overrides the entry point of every filter the extension contributes, so the documented `at: pre-quarto` pulled the Typst title hotfix from `post-quarto` to `pre-quarto`; the manifest already carries both entry points.
+
 ## 1.3.1 (2026-08-01)
 
 ### Bug Fixes
diff --git a/docs/index.qmd b/docs/index.qmd
index 6fb2883..2b42bc7 100644
--- a/docs/index.qmd
+++ b/docs/index.qmd
@@ -17,8 +17,7 @@ Every named code block on this site is drawn by it, including this one:
 
 ```{.yaml filename="_quarto.yml"}
 filters:
-  - path: code-window
-    at: pre-quarto
+  - code-window
 ```
 
 ## Installation
@@ -44,8 +43,7 @@ Or install it from your editor with [Quarto Wizard](https://m.canouil.dev/quarto
 
 ```yaml
 filters:
-  - path: code-window
-    at: pre-quarto
+  - code-window
 ```
 
 Name the file, and the block is framed with it:
diff --git a/docs/reference.qmd b/docs/reference.qmd
index 1214f61..6b66f21 100644
--- a/docs/reference.qmd
+++ b/docs/reference.qmd
@@ -8,8 +8,7 @@ description: "The complete code-window configuration: the document options, the
 
 ```yaml
 filters:
-  - path: code-window
-    at: pre-quarto
+  - code-window
 ```
 
 ## Options
diff --git a/example.qmd b/example.qmd
index 492dbf3..061edcd 100644
--- a/example.qmd
+++ b/example.qmd
@@ -6,8 +6,7 @@ author:
     orcid: "0000-0002-3396-4549"
     url: "https://mickael.canouil.fr"
 filters:
-  - at: pre-quarto
-    path: code-window
+  - code-window
 syntax-highlighting: github-dark
 code-annotations: below
 toc: true