From 03f363d37884fe68d2f84a3def3fd6fe7bf4a506 Mon Sep 17 00:00:00 2001
From: Hennadii Stepanov <32963518+hebasto@users.noreply.github.com>
Date: Mon, 19 Jan 2026 17:05:59 +0000
Subject: [PATCH] doc: Document IWYU workaround

---
 src/core_io.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/core_io.cpp b/src/core_io.cpp
index a789d5ca947..58989115a50 100644
--- a/src/core_io.cpp
+++ b/src/core_io.cpp
@@ -10,6 +10,9 @@
 #include <consensus/consensus.h>
 #include <consensus/validation.h>
 #include <key_io.h>
+// IWYU incorrectly suggests replacing this header
+// with forward declarations.
+// See https://github.com/include-what-you-use/include-what-you-use/issues/1886.
 #include <primitives/block.h> // IWYU pragma: keep
 #include <primitives/transaction.h>
 #include <script/descriptor.h>