diff --git a/src/primitives/decode.rs b/src/primitives/decode.rs
index b0c0e133a..95a614563 100644
--- a/src/primitives/decode.rs
+++ b/src/primitives/decode.rs
@@ -5,7 +5,7 @@
 //! You should only need to use this module directly if you want control over exactly what is
 //! checked and when it is checked (correct bech32 characters, valid checksum, valid checksum for
 //! specific checksum algorithm, etc). If you are parsing/validating modern (post BIP-350) bitcoin
-//! segwit addresses consider using the higher crate level API.
+//! segwit addresses consider using the [`crate::segwit`] API.
 //!
 //! If you do find yourself using this module directly then consider using the most general type
 //! that serves your purposes, each type can be created by parsing an address string to `new`. You
diff --git a/src/primitives/encode.rs b/src/primitives/encode.rs
index dea44a36d..bc3dd6af4 100644
--- a/src/primitives/encode.rs
+++ b/src/primitives/encode.rs
@@ -7,7 +7,7 @@
 //! prepending HRP strings etc.
 //!
 //! In general, directly using these adaptors is not very ergonomic, and users are recommended to
-//! instead use the higher crate level API.
+//! instead use the crate level API.
 //!
 //! # Examples
 //!