docs: update ::hex references

Author: DaniPopes

README.md

@@ -8,8 +8,9 @@
 This crate provides a fast conversion of byte arrays to hexadecimal strings,
 both at compile time, and at run time.
 
-Extends the [`hex`] crate's implementation with [const-eval], a
-[const-generics formatting buffer][buffer], similar to [`itoa`]'s, and more.
+It aims to be a drop-in replacement for the [`hex`] crate, as well as extending
+the API with [const-eval], a [const-generics formatting buffer][buffer], similar
+to [`itoa`]'s, and more.
 
 _Version requirement: rustc 1.64+_
 

src/lib.rs

@@ -7,13 +7,15 @@
 //! This crate provides a fast conversion of byte arrays to hexadecimal strings,
 //! both at compile time, and at run time.
 //!
-//! Extends the [`hex`] crate's implementation with [const-eval](const_encode), a
+//! It aims to be a drop-in replacement for the [`hex`] crate, as well as
+//! extending the API with [const-eval](const_encode), a
 //! [const-generics formatting buffer](Buffer), similar to [`itoa`]'s, and more.
 //!
 //! _Version requirement: rustc 1.64+_
 //!
 //! [`itoa`]: https://docs.rs/itoa/latest/itoa/struct.Buffer.html
-#![cfg_attr(not(feature = "hex"), doc = "[`hex`]: https://docs.rs/hex")]
+//! [`hex`]: https://docs.rs/hex
+
 #![cfg_attr(not(feature = "std"), no_std)]
 #![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
 #![cfg_attr(

src/traits.rs

@@ -19,8 +19,6 @@ use alloc::{
 /// This trait is implemented for all `T` which implement `AsRef<[u8]>`. This
 /// includes `String`, `str`, `Vec<u8>` and `[u8]`.
 ///
-/// *Note*: instead of using this trait, you might want to use [`encode`](crate::encode) or [`ToHexExt`].
-///
 /// # Examples
 ///
 /// ```
@@ -32,7 +30,7 @@ use alloc::{
 /// ```
 #[cfg_attr(feature = "alloc", doc = "\n[`encode`]: crate::encode")]
 #[cfg_attr(not(feature = "alloc"), doc = "\n[`encode`]: crate::encode_to_slice")]
-#[deprecated(note = "use `encode` or other specialized functions instead")]
+#[deprecated(note = "use `ToHexExt` instead")]
 pub trait ToHex {
     /// Encode the hex strict representing `self` into the result.
     /// Lower case letters are used (e.g. `f9b4ca`).
@@ -43,9 +41,10 @@ pub trait ToHex {
     fn encode_hex_upper<T: iter::FromIterator<char>>(&self) -> T;
 }
 
-/// Encoding values as hex string with prefix `0x`.
+/// Encoding values as hex string.
 ///
-/// This trait is implemented for all `T` which implement `AsRef<[u8]>`.
+/// This trait is implemented for all `T` which implement `AsRef<[u8]>`. This
+/// includes `String`, `str`, `Vec<u8>` and `[u8]`.
 ///
 /// # Examples
 ///