Update doc

src/encoding/encoder.rs

@@ -45,9 +45,9 @@ impl Encoder for Port {
 
 /// An encoder for URI path.
 ///
-/// [`EStr`] has extension methods for the path component.
+/// `EStr` has [extension methods] for the path component.
 ///
-/// [`EStr`]: super::EStr
+/// [extension methods]: super::EStr#impl-EStr<E>-1
 #[derive(Debug, Clone, Copy)]
 pub struct Path(());
 
@@ -57,9 +57,9 @@ impl Encoder for Path {
 
 /// An encoder for IRI path.
 ///
-/// [`EStr`] has extension methods for the path component.
+/// `EStr` has [extension methods] for the path component.
 ///
-/// [`EStr`]: super::EStr
+/// [extension methods]: super::EStr#impl-EStr<E>-1
 #[derive(Debug, Clone, Copy)]
 pub struct IPath(());
 

src/encoding/mod.rs

@@ -146,11 +146,20 @@ impl<E: Encoder> EStr<E> {
         self.inner.is_empty()
     }
 
-    /// Upcasts the `EStr` slice to associate with the given super-encoder.
+    /// Upcasts the `EStr` slice to associate it with the given super-encoder.
     ///
     /// # Panics
     ///
     /// Panics at compile time if `E` is not a [sub-encoder](Encoder#sub-encoders) of `SuperE`.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// use fluent_uri::encoding::{encoder::{IPath, Path}, EStr};
+    ///
+    /// let path = EStr::<Path>::new_or_panic("foo");
+    /// let path: &EStr<IPath> = path.upcast();
+    /// ```
     #[cfg(fluent_uri_unstable)]
     #[must_use]
     pub fn upcast<SuperE: Encoder>(&self) -> &EStr<SuperE> {

src/ri.rs

@@ -326,9 +326,10 @@ macro_rules! ri_maybe_ref {
             ///
             /// The path component is always present, although it may be empty.
             ///
-            /// The returned [`EStr`] slice has extension methods for the path component.
+            /// The returned `EStr` slice has [extension methods] for the path component.
             ///
             /// [path]: https://datatracker.ietf.org/doc/html/rfc3986#section-3.3
+            /// [extension methods]: EStr#impl-EStr<E>-1
             ///
             /// # Examples
             ///