diff --git a/ruma-events/src/json.rs b/ruma-events/src/json.rs
index ff54f6ef..895ac588 100644
--- a/ruma-events/src/json.rs
+++ b/ruma-events/src/json.rs
@@ -12,8 +12,8 @@ use serde_json::value::RawValue;
 
 use crate::EventContent;
 
-/// A wrapper around `Box<RawValue>`, to be used in place of event [content] [collection] types in
-/// Matrix endpoint definition to allow request and response types to contain unknown events in
+/// A wrapper around `Box<RawValue>`, to be used in place of event \[content\] \[collection\] types
+/// in Matrix endpoint definition to allow request and response types to contain unknown events in
 /// addition to the known event(s) represented by the generic argument `Ev`.
 pub struct EventJson<T> {
     json: Box<RawValue>,
diff --git a/ruma-federation-api/src/membership/create_join_event_template/v1.rs b/ruma-federation-api/src/membership/create_join_event_template/v1.rs
index 84f88699..d1364928 100644
--- a/ruma-federation-api/src/membership/create_join_event_template/v1.rs
+++ b/ruma-federation-api/src/membership/create_join_event_template/v1.rs
@@ -23,7 +23,7 @@ ruma_api! {
         #[ruma_api(path)]
         pub user_id: UserId,
         #[ruma_api(query)]
-        /// The room versions the sending server has support for. Defaults to [1].
+        /// The room versions the sending server has support for. Defaults to 1.
         #[serde(skip_serializing_if = "Vec::is_empty")]
         pub ver: Vec<UInt>,
     }