diff --git a/src/model/permissions.rs b/src/model/permissions.rs
index 5cef30962b3..10fb903a773 100644
--- a/src/model/permissions.rs
+++ b/src/model/permissions.rs
@@ -104,9 +104,13 @@ macro_rules! generate_permissions {
 
         impl Permissions {
             $(
-                #[doc = concat!("Shorthand for checking that the set of permissions contains the [", $name, "] permission.")]
-                #[doc = ""]
-                #[doc = concat!("[", $name, "]: Self::", stringify!($perm_upper))]
+                #[doc = concat!(
+                    "Shorthand for checking that the set of permissions contains the [",
+                    $name,
+                    "](Self::",
+                    stringify!($perm_upper),
+                    ") permission."
+                )]
                 #[must_use]
                 $(
                     #[deprecated = $deprecated]