From 2be947454363c57c8ef7c14f6bc00428fbc8d993 Mon Sep 17 00:00:00 2001 From: Maksym Kacharaba Date: Sat, 7 Nov 2026 13:48:58 +0200 Subject: [PATCH] docs: stop counting diagnostics in the root README It said "eighteen" against a live set of twenty-three. Four PRs added diagnostics and each updated the page it was thinking about; the root README was nobody's page. Replaced the count with examples and a link to the reference, which is generated from nothing and therefore cannot drift. A number in prose is a maintenance burden that buys the reader nothing a link does not. Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 2cfbabc..f54d20a 100644 --- a/README.md +++ b/README.md @@ -39,10 +39,11 @@ public interface IRepositoryClient ``` A source generator emits the implementation at compile time — no reflection, no proxy types, -trimming- and AOT-safe. Mistakes are build errors rather than 3am production errors: eighteen -diagnostics cover a `{placeholder}` with no matching parameter, two `[Body]` parameters, an -unbindable parameter, a synchronous return type, a non-absolute `[BaseAddress]`, and more — each -with a location and a sentence saying what to do. +trimming- and AOT-safe. Mistakes are build errors rather than 3am production errors: a +`{placeholder}` with no matching parameter, two `[Body]` parameters, an unbindable parameter, a +synchronous return type, a non-absolute `[BaseAddress]`, a query type that cannot be sent, a +response type missing from your JSON context — each with a location and a sentence saying what to +do. The full set is in [docs/diagnostics.md](docs/diagnostics.md). A parameter with no attribute binds to a path placeholder of the same name. Anything else is an error, because guessing that an unbound parameter "must be a query parameter" is how a secret ends