diff --git a/service/graphql/schema.graphqls b/service/graphql/schema.graphqls
index 24344fff..43801d4d 100644
--- a/service/graphql/schema.graphqls
+++ b/service/graphql/schema.graphqls
@@ -120,6 +120,11 @@ type Venue {
 
   descriptionFr: String!
 
+  """
+   The description of the venue. [description] may contain emojis and '\n' Chars but no markdown or HTML.
+
+   May be null if no description is available.
+  """
   description(language: String = "en"): String!
 }
 
@@ -134,6 +139,11 @@ type Session implements Node {
 
   title: String!
 
+  """
+   The description of the event. [description] may contain emojis and '\n' Chars but no markdown or HTML.
+
+   May be null if no description is available.
+  """
   description: String
 
   """
diff --git a/service/src/commonMain/kotlin/androidmakers/service/graphql/model.kt b/service/src/commonMain/kotlin/androidmakers/service/graphql/model.kt
index a76de8c4..e896fd2d 100644
--- a/service/src/commonMain/kotlin/androidmakers/service/graphql/model.kt
+++ b/service/src/commonMain/kotlin/androidmakers/service/graphql/model.kt
@@ -291,6 +291,11 @@ sealed interface Node {
 data class Session(
     override val id: String,
     val title: String,
+    /**
+     * The description of the event. [description] may contain emojis and '\n' Chars but no markdown or HTML.
+     *
+     * May be null if no description is available.
+     */
     val description: String?,
     /**
      * A shorter version of description for use when real estate is scarce like watches for an example.
@@ -424,6 +429,11 @@ data class Venue(
             return descriptions.get("\"fr\"") ?: descriptions.get("en") ?: ""
         }
 
+    /**
+     * The description of the venue. [description] may contain emojis and '\n' Chars but no markdown or HTML.
+     *
+     * May be null if no description is available.
+     */
     fun description(@GraphQLDefault("\"en\"") language: String?): String {
         return descriptions.get(language) ?: descriptions.get("en") ?: ""
     }