nit: documentation could be made more consistent, as per e.g. the below diff
0diff --git a/src/net.h b/src/net.h
1index 61b25bd47d..eb08d9de05 100644
2--- a/src/net.h
3+++ b/src/net.h
4@@ -1169,9 +1169,10 @@ public:
5
6 // Addrman functions
7 /**
8- * Return all or many randomly selected addresses, optionally by network.
9- * This function does not use an address response cache and should only be
10- * used in trusted contexts.
11+ * Return randomly selected addresses. This function does not use the address response cache and
12+ * should only be used in trusted contexts.
13+ *
14+ * An untrusted caller (e.g. from p2p) should instead use [@ref](/bitcoin-bitcoin/contributor/ref/) GetAddresses to use the cache.
15 *
16 * [@param](/bitcoin-bitcoin/contributor/param/)[in] max_addresses Maximum number of addresses to return (0 = all).
17 * [@param](/bitcoin-bitcoin/contributor/param/)[in] max_pct Maximum percentage of addresses to return (0 = all). Value must be from 0 to 100.
18@@ -1180,12 +1181,18 @@ public:
19 */
20 std::vector<CAddress> GetAddressesUncached(size_t max_addresses, size_t max_pct, std::optional<Network> network, const bool filtered = true) const;
21 /**
22- * Return all or many addresses, using the address response cache.
23- * Cache is used to minimize topology leaks, so it should be used for all
24- * non-trusted calls, for example, p2p.
25+ * Return addresses from the per-requestor cache. If no cache entry exists, it is populated with
26+ * randomly selected addresses. This function can be used in untrusted contexts.
27+ *
28+ * A trusted caller (e.g. from RPC or a peer with addr permission) can use
29+ * [@ref](/bitcoin-bitcoin/contributor/ref/) GetAddressesUncached to avoid using the cache.
30 *
31- * A non-malicious call (from RPC or a peer with addr permission) should
32- * instead use GetAddressesUncached to avoid using the cache.
33+ * [@param](/bitcoin-bitcoin/contributor/param/)[in] requestor The requesting peer. Used to key the cache to prevent privacy leaks.
34+ * [@param](/bitcoin-bitcoin/contributor/param/)[in] max_addresses Maximum number of addresses to return (0 = all). Ignored when cache
35+ * already contains an entry for requestor.
36+ * [@param](/bitcoin-bitcoin/contributor/param/)[in] max_pct Maximum percentage of addresses to return (0 = all). Value must be
37+ * from 0 to 100. Ignored when cache already contains an entry for
38+ * requestor.
39 */
40 std::vector<CAddress> GetAddresses(CNode& requestor, size_t max_addresses, size_t max_pct);
41