Improve api documentation

src/api/room_cmds.rs

@@ -1,4 +1,7 @@
 //! Chat room commands.
+//!
+//! These commands are available to the client once a session successfully joins
+//! a room.
 
 use serde::{Deserialize, Serialize};
 
@@ -17,8 +20,9 @@ pub struct GetMessageReply(pub Message);
 
 /// Request messages from the room's message log.
 ///
-/// This can be used to supplement the log provided by snapshot-event (for
+/// This can be used to supplement the log provided by
-/// example, when scrolling back further in history).
+/// [`SnapshotEvent`](super::SnapshotEvent) (for example, when scrolling back
+/// further in history).
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct Log {
     /// Maximum number of messages to return (up to 1000).

src/api/session_cmds.rs

@@ -1,4 +1,7 @@
 //! Session commands.
+//!
+//! Session management commands are involved in the initial handshake and
+//! maintenance of a session.
 
 use serde::{Deserialize, Serialize};
 
@@ -6,8 +9,8 @@ use super::{AuthOption, Time};
 
 /// Attempt to join a private room.
 ///
-/// This should be sent in response to a bounce event at the beginning of a
+/// This should be sent in response to a [`BounceEvent`](super::BounceEvent) at
-/// session.
+/// the beginning of a session.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct Auth {
     /// The method of authentication.