chore: resolve rustdoc warnings

Author: kbalt

media/sdp-types/src/media_description.rs

@@ -8,7 +8,7 @@ use crate::{
 use bytesstr::BytesStr;
 use std::fmt::{self, Debug};
 
-/// Part of the [`SessionDescription`] describes a single media session
+/// Part of the [`SessionDescription`](crate::SessionDescription) describes a single media session
 ///
 /// [RFC8866](https://www.rfc-editor.org/rfc/rfc8866.html#section-5.14)
 #[derive(Debug, Clone)]

sip/sip-types/src/header/headers.rs

@@ -57,13 +57,13 @@ impl Headers {
         self.entries.iter().any(|entry| &entry.name == name)
     }
 
-    /// Inserts `header` using its [`HeaderNamed`] and [`InsertIntoHeaders`] implementation to the front of the list
+    /// Inserts `header` using its [`DynNamed`] and [`ExtendValues`] implementation to the front of the list
     #[inline]
     pub fn insert_named_front<H: DynNamed + ExtendValues + ?Sized>(&mut self, header: &H) {
         self.insert_type_front(header.name(), header)
     }
 
-    /// Inserts `header` using its [`InsertIntoHeaders`] implementation to the front of the list
+    /// Inserts `header` using its [`ExtendValues`] implementation to the front of the list
     #[inline]
     pub fn insert_type_front<H: ExtendValues + ?Sized>(&mut self, name: Name, header: &H) {
         let ctx = PrintCtx::default();

sip/sip-types/src/header/mod.rs

@@ -19,13 +19,13 @@ pub use error::HeaderError;
 
 /// Assign a constant header name to a type.
 ///
-/// Is used by [`Headers`]'s `(get/take)_named` API so no
+/// Is used by [`Headers`](headers::Headers)'s `(get/take)_named` API so no
 /// name has to be provided by the caller.
 pub trait ConstNamed {
     const NAME: Name;
 }
 
-/// Decode a header from one or more values. Used to parse headers from [`Headers`].
+/// Decode a header from one or more values. Used to parse headers from [`Headers`](headers::Headers).
 pub trait DecodeValues: Sized {
     /// Decode a header from a iterator of [`BytesStr`].
     ///
@@ -44,7 +44,7 @@ pub trait HeaderParse: Sized {
 // ==== PRINT TRAITS ====
 
 /// Assign a dynamic header name to a type.
-/// Used for [`Headers`]'s `insert_named(_front)` API.
+/// Used for [`Headers`](headers::Headers)'s `insert_named(_front)` API.
 ///
 /// Can be used for enum holding different header variants.
 pub trait DynNamed {
@@ -57,7 +57,7 @@ impl<T: ConstNamed> DynNamed for T {
     }
 }
 
-/// Insert a header type into [`Header`].
+/// Insert a header type into [`Header`](headers::Headers).
 pub trait ExtendValues {
     /// Called when there already existing values.
     ///
@@ -67,7 +67,7 @@ pub trait ExtendValues {
 
     /// Called when there are no existing values.
     ///
-    /// Must generate header value to be inserted into [`Headers`].
+    /// Must generate header value to be inserted into [`Headers`](headers::Headers).
     fn create_values(&self, ctx: PrintCtx<'_>) -> OneOrMore;
 }
 

sip/sip-types/src/header/typed/auth.rs

@@ -517,12 +517,12 @@ impl Display for Algorithm {
 }
 
 /// AKA versions
-/// https://www.iana.org/assignments/aka-version-namespace/aka-version-namespace.xhtml
+/// <https://www.iana.org/assignments/aka-version-namespace/aka-version-namespace.xhtml>
 #[derive(Debug, Clone, PartialEq, Eq)]
 pub enum AkaVersion {
-    /// https://datatracker.ietf.org/doc/html/rfc3310
+    /// <https://datatracker.ietf.org/doc/html/rfc3310>
     AKAv1,
-    /// https://datatracker.ietf.org/doc/html/rfc4169
+    /// <https://datatracker.ietf.org/doc/html/rfc4169>
     AKAv2,
     Other(BytesStr),
 }

sip/sip-types/src/header/typed/from_to.rs

@@ -10,7 +10,7 @@ use nom::combinator::map;
 use nom::sequence::tuple;
 use std::fmt;
 
-/// Type which is being wrapped by [From] and [To]
+/// Type which represent the `From` and `To` header value
 #[derive(Debug, Clone)]
 pub struct FromTo {
     pub uri: NameAddr,