From fc61cb9310dc0352ae1d217ee3efe0d52c0bc04c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?m=C3=BCde?= <git@darkest.space>
Date: Fri, 15 May 2026 23:11:10 +0200
Subject: [PATCH] fmt: clippy doc_markdown backticks

---
 hive-c0re/src/actions.rs   | 20 ++++++++++----------
 hive-c0re/src/approvals.rs |  2 +-
 hive-c0re/src/lifecycle.rs |  2 +-
 hive-sh4re/src/lib.rs      |  2 +-
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/hive-c0re/src/actions.rs b/hive-c0re/src/actions.rs
index 078aeac..fc18d29 100644
--- a/hive-c0re/src/actions.rs
+++ b/hive-c0re/src/actions.rs
@@ -127,16 +127,16 @@ fn finish_approval(
     result
 }
 
-/// Tag-driven ApplyCommit handler. Walks the approval through the tag
-/// state machine documented in `docs/approvals.md`: stamp `approved/<id>`
-/// + `building/<id>` first so the audit trail captures intent, then
-/// drop the candidate tree into the working dir without moving HEAD,
-/// run the rebuild, and either fast-forward `applied/main` to the
-/// proposal commit on success (`deployed/<id>`) or annotate
-/// `failed/<id>` with the build error and reset the working tree back
-/// to the last known-good main. main never advances on a failed
-/// build, so a crash-and-recover doesn't leave the agent pointing at
-/// a tree it can't evaluate.
+/// Tag-driven `ApplyCommit` handler. Walks the approval through the tag
+/// state machine documented in `docs/approvals.md`: stamp
+/// `approved/<id>` and `building/<id>` first so the audit trail
+/// captures intent, then drop the candidate tree into the working dir
+/// without moving HEAD, run the rebuild, and either fast-forward
+/// `applied/main` to the proposal commit on success
+/// (`deployed/<id>`) or annotate `failed/<id>` with the build error
+/// and reset the working tree back to the last known-good main. main
+/// never advances on a failed build, so a crash-and-recover doesn't
+/// leave the agent pointing at a tree it can't evaluate.
 async fn run_apply_commit(
     coord: &Arc<Coordinator>,
     approval: &hive_sh4re::Approval,
diff --git a/hive-c0re/src/approvals.rs b/hive-c0re/src/approvals.rs
index 926aad5..f53aebf 100644
--- a/hive-c0re/src/approvals.rs
+++ b/hive-c0re/src/approvals.rs
@@ -42,7 +42,7 @@ fn ensure_kind_column(conn: &Connection) -> Result<()> {
 }
 
 /// Same shape as `ensure_kind_column` but for `fetched_sha` — the
-/// canonical sha hive-c0re vouched for at request_apply_commit time.
+/// canonical sha hive-c0re vouched for at `request_apply_commit` time.
 /// Distinct from `commit_ref` (manager-supplied, may not even resolve
 /// in proposed by the time we approve).
 fn ensure_fetched_sha_column(conn: &Connection) -> Result<()> {
diff --git a/hive-c0re/src/lifecycle.rs b/hive-c0re/src/lifecycle.rs
index 3d10edf..cba109a 100644
--- a/hive-c0re/src/lifecycle.rs
+++ b/hive-c0re/src/lifecycle.rs
@@ -470,7 +470,7 @@ async fn git(dir: &Path, args: &[&str]) -> Result<()> {
 }
 
 /// Fetch `sha` from the `src` git repo into `dst` and pin it as
-/// `refs/tags/<tag>`. Used at request_apply_commit time so hive-c0re
+/// `refs/tags/<tag>`. Used at `request_apply_commit` time so hive-c0re
 /// captures an immutable handle on the manager's commit; subsequent
 /// amendments / force-pushes in `src` no longer affect what gets
 /// built. Returns the resolved sha (which equals `sha` on success
diff --git a/hive-sh4re/src/lib.rs b/hive-sh4re/src/lib.rs
index 63b1493..5d4a4fb 100644
--- a/hive-sh4re/src/lib.rs
+++ b/hive-sh4re/src/lib.rs
@@ -281,7 +281,7 @@ pub enum HelperEvent {
         /// Sha that ended up at `deployed/<id>` on success, or the
         /// proposal sha that just got tagged `failed/<id>` on
         /// failure. None for the (rare) rebuild path that doesn't go
-        /// through an approval (e.g. auto_update::rebuild_agent
+        /// through an approval (e.g. `auto_update::rebuild_agent`
         /// reapplying the existing main).
         #[serde(default, skip_serializing_if = "Option::is_none")]
         sha: Option<String>,