send /top as document, add docstrings to doc structs

1 files changed, 9 insertions, 2 deletions

diff --git a/server/protocol/src/lib.rs b/server/protocol/src/lib.rs
index 3337db0a..dd773a3d 100644
--- a/server/protocol/src/lib.rs
+++ b/server/protocol/src/lib.rs
@@ -353,24 +353,31 @@ pub enum DocumentElement {
     Document {
         es: Vec<DocumentElement>,
     },
+    /// One page of the document, √2:1 aspect ratio
     Page {
+        /// Name of background image
         background: Option<String>,
         es: Vec<DocumentElement>,
     },
     List {
+        /// Should only contain par or text elements
         es: Vec<DocumentElement>,
     },
+    /// Table with elements arranged as row arrays
     Table {
         es: Vec<Vec<DocumentElement>>,
     },
+    /// A paragraph.
     Par {
+        /// Should only contain text elements
         es: Vec<DocumentElement>,
     },
+    /// A text span
     Text {
         s: Message,
-        color: String,
         size: f32,
-        font: String,
+        color: Option<String>,
+        font: Option<String>,
         #[serde(default)]
         bold: bool,
     },