diff --git a/docs/DOCUMENTATION_GUIDELINES.md b/docs/DOCUMENTATION_GUIDELINES.md
index 29029b894c76..5d1164e8ca89 100644
--- a/docs/DOCUMENTATION_GUIDELINES.md
+++ b/docs/DOCUMENTATION_GUIDELINES.md
@@ -210,7 +210,7 @@ The guidelines so far have been general in nature, and are applicable to crates
 pallets.
 
 The following is relevant to how to document parts of a crate that is a pallet. See
-[`pallet-fast-unstake`](../frame/fast-unstake/src/lib.rs) as one example of adhering these guidelines.
+[`pallet-fast-unstake`](../substrate/frame/fast-unstake/src/lib.rs) as one example of adhering these guidelines.
 
 ---
 
diff --git a/substrate/frame/broker/README.md b/substrate/frame/broker/README.md
index a3c4b251a452..eae0442dbf69 100644
--- a/substrate/frame/broker/README.md
+++ b/substrate/frame/broker/README.md
@@ -2,7 +2,7 @@
 
 Brokerage tool for managing Polkadot Core scheduling.
 
-Properly described in RFC-0001 Agile Coretime.
+Properly described in [RFC-0001 Agile Coretime](https://github.com/polkadot-fellows/RFCs/blob/main/text/0001-agile-coretime.md).
 
 ## Implementation Specifics