diff --git a/src/xrpld/app/ledger/detail/LedgerSpanNames.h b/src/xrpld/app/ledger/detail/LedgerSpanNames.h
index a359e5d2c7..8f6a42aed1 100644
--- a/src/xrpld/app/ledger/detail/LedgerSpanNames.h
+++ b/src/xrpld/app/ledger/detail/LedgerSpanNames.h
@@ -1,6 +1,7 @@
 #pragma once
 
-/** Compile-time span name constants for ledger tracing.
+/**
+ * Compile-time span name constants for ledger tracing.
  *
  *  Used by BuildLedger and LedgerMaster for ledger lifecycle spans.
  *  Built on StaticStr/join() from SpanNames.h.
@@ -29,14 +30,18 @@ inline constexpr auto apply = makeStr("apply");
 // ===== Attribute keys ========================================================
 
 namespace attr {
-/// Canonical shared constants (defined in SpanNames.h).
+/**
+ * Canonical shared constants (defined in SpanNames.h).
+ */
 using ::xrpl::telemetry::attr::closeResolutionMs;
 using ::xrpl::telemetry::attr::closeTime;
 using ::xrpl::telemetry::attr::closeTimeCorrect;
 using ::xrpl::telemetry::attr::ledgerHash;
 using ::xrpl::telemetry::attr::ledgerSeq;
 
-/// Domain-owned bare attrs.
+/**
+ * Domain-owned bare attrs.
+ */
 inline constexpr auto txCount = makeStr("tx_count");
 inline constexpr auto txFailed = makeStr("tx_failed");
 inline constexpr auto validations = makeStr("validations");
diff --git a/src/xrpld/overlay/detail/PeerSpanNames.h b/src/xrpld/overlay/detail/PeerSpanNames.h
index 3e6530c486..6212d8fca2 100644
--- a/src/xrpld/overlay/detail/PeerSpanNames.h
+++ b/src/xrpld/overlay/detail/PeerSpanNames.h
@@ -1,6 +1,7 @@
 #pragma once
 
-/** Compile-time span name constants for peer overlay tracing.
+/**
+ * Compile-time span name constants for peer overlay tracing.
  *
  *  Used by PeerImp for peer message handling spans (proposals,
  *  validations). Built on StaticStr/join() from SpanNames.h.
@@ -25,14 +26,18 @@ inline constexpr auto validationReceive = makeStr("validation.receive");
 // ===== Attribute keys ========================================================
 
 namespace attr {
-/// Canonical shared constants (defined in SpanNames.h). `ledgerHash` and
-/// `fullValidation` are shared with the consensus validation spans — same
-/// concept, same key, told apart by span name.
+/**
+ * Canonical shared constants (defined in SpanNames.h). `ledgerHash` and
+ * `fullValidation` are shared with the consensus validation spans — same
+ * concept, same key, told apart by span name.
+ */
 using ::xrpl::telemetry::attr::fullValidation;
 using ::xrpl::telemetry::attr::ledgerHash;
 using ::xrpl::telemetry::attr::peerId;
 
-/// Trust flag qualified by message type, shared with consensus.*.receive.
+/**
+ * Trust flag qualified by message type, shared with consensus.*.receive.
+ */
 inline constexpr auto proposalTrusted = makeStr("proposal_trusted");
 inline constexpr auto validationTrusted = makeStr("validation_trusted");
 }  // namespace attr