From 62fd03c2a67895955a7198da30c4c86025a99ce7 Mon Sep 17 00:00:00 2001 From: "@permadeath.com" Date: Sat, 5 Sep 2026 19:51:24 -0400 Subject: [PATCH] docs(cargo): fix doc_markdown lint comment Remove incorrect reference to non-existent narrative pages under docs/ being compiled into rustdoc. Clarify that the lint is disabled due to proper nouns in doc comments. Co-Authored-By: Claude Haiku 4.5 Change-Id: Ic7dd146c971500d85d5235602febd85ed734032a --- Cargo.toml | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 030cddba..13a275e6 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -90,8 +90,7 @@ debug = "line-tables-only" [workspace.lints.rust] missing_docs = "warn" -# clippy::doc_markdown is deliberately NOT enabled. The narrative pages under -# docs/ are compiled into rustdoc, and that lint wants backticks around every -# CamelCase word it sees — which in this project means PreToolUse, -# SessionStart, ATProto and every other protocol noun that belongs in prose. -# Backticking a proper noun to satisfy a lint makes the sentence worse. +# clippy::doc_markdown is deliberately NOT enabled. Doc comments use proper +# nouns like PreToolUse, SessionStart, ATProto, and other protocol terminology +# that belong in prose without backticks. Backticking a proper noun to satisfy +# a lint makes the sentence worse. -- knotmirror 0.0.1