Update lexicon descriptions

src/lexicons/site.standard.document.ts

···
             site: lx.string({
                 required: true,
                 format: 'uri',
-                description: 'Required URI for parent site or publication (https:// or at://). Use https:// for loose documents. Avoid trailing slashes.'
+                description: 'Points to a publication record (at://) or a publication url (https://) for loose documents. Avoid trailing slashes.'
             }),
             path: lx.string({
-                description: 'Optional path, combined with site or publication url value to construct a full url to the document. Prepend with a leading slash.'
+                description: 'Combine with site or publication url to construct a canonical URL to the document. Prepend with a leading slash.'
             }),
             title: lx.string({
                 required: true,
                 maxLength: 1280,
                 maxGraphemes: 128,
-                description: 'Required title of the document.'
+                description: 'Title of the document.'
             }),
             description: lx.string({
                 maxLength: 3000,
                 maxGraphemes: 300,
-                description: 'Optional brief description or expert of the document.'
+                description: 'A brief description or excerpt from the document.'
             }),
             coverImage: lx.blob({
                 maxSize: 1 * MB,
                 accept: ['image/*'],
-                description: 'Optional image to use as the documents cover. Less than 1MB is size.'
+                description: 'Image to used for thumbnail or cover image. Less than 1MB is size.'
             }),
             content: lx.union([], {
                 closed: false,
-                description: 'Optional open union to construct content within the record. Can be extended with other lexicons to define any content format.'
+                description: 'Open union used to define the record\'s content. Each entry must specify a $type and may be extended with other lexicons to support additional content formats.'
             }),
             textContent: lx.string({
-                description: 'Optional plaintext representation of the documents contents. Useful for search and other cases.'
+                description: 'Plaintext representation of the documents contents. Should not contain markdown or other formatting.'
             }),
             bskyPostRef: lx.ref('com.atproto.repo.strongRef', {
-                description: 'Optional strong reference to a Bluesky post. Useful to keep track of comments off-platform.'
+                description: 'Strong reference to a Bluesky post. Useful to keep track of comments off-platform.'
             }),
             tags: lx.array({
                 type: 'string',
             }, {
                 maxLength: 100,
-                description: 'Optional array of strings used to tag/categorize the document. Avoid prepending tags with hashtags ("#").'
+                description: 'Array of strings used to tag or categorize the document. Avoid prepending tags with hashtags.'
             }),
             publishedAt: lx.string({
                 required: true,
                 format: 'datetime',
-                description: 'Required timestamp of the documents publication.'
+                description: 'Timestamp of the documents publish time.'
             }),
             updatedAt: lx.string({
                 format: 'datetime',
-                description: 'Optional timestamp of the documents last edit.'
+                description: 'Timestamp of the documents last edit.'
             })
         }),
+        description: 'A document record representing a published article, blog post, or other content. Documents can belong to a publication or exist independently.'
     })
 })

src/lexicons/site.standard.graph.subscription.ts

···
             publication: lx.string({
                 required: true,
                 format: 'at-uri',
-                description: 'Required publication at-uri.'
+                description: 'AT-URI reference to the publication record being subscribed to (ex: at://did:plc:abc123/site.standard.publication/xyz789).'
             })
         }),
         description: 'Record declaring a subscription to a publication.'

src/lexicons/site.standard.publication.ts

···
             url: lx.string({
                 required: true,
                 format: 'uri',
-                description: 'Required base publication URL (ex: https://standard.site).'
+                description: 'Base publication url (ex: https://standard.site). The canonical document URL is formed by combining this value with the document path.'
             }),
             icon: lx.blob({
                 maxSize: 1 * MB,
-                accept: ['image/*']
+                accept: ['image/*'],
+                description: 'Square image to identify the publication. Should be at least 256x256.'
             }),
             name: lx.string({
                 required: true,
                 maxLength: 1280,
                 maxGraphemes: 128,
-                description: 'Required name of the publication.'
+                description: 'Name of the publication.'
             }),
             description: lx.string({
                 maxLength: 3000,
                 maxGraphemes: 300,
-                description: 'Optional brief description of the publication.'
+                description: 'Brief description of the publication.'
             }),
             basicTheme: lx.ref(siteStandardThemeBasic.json.id, {
-                description: 'Optional simplified publication theme for tools and apps to easily implement when displaying content.'
+                description: 'Simplified publication theme for tools and apps to utilize when displaying content.'
             }),
             preferences: lx.ref('#preferences', {
-                description: 'Optional object containing platform specific preferences (with a few shared properties).'
+                description: 'Object containing platform specific preferences (with a few shared properties).'
             })
         }),
+        description: 'A publication record representing a blog, website, or content platform. Publications serve as containers for documents and define the overall branding and settings.'
     }),
     preferences: lx.object({
         showInDiscover: lx.boolean({
             default: true,
-            description: 'Optional boolean which decides whether the publication should appear in discovery feeds.'
-        })
+            description: 'Boolean which decides whether the publication should appear in discovery feeds.'
+        }),
+        description: 'Platform-specific preferences for the publication, including discovery and visibility settings.'
     })
 })

src/lexicons/site.standard.theme.basic.ts

···
         record: lx.object({
             background: lx.union([siteStandardThemeColor.json.id + '#rgb'], {
                 required: true,
-                description: 'Required color used for content background.'
+                description: 'Color used for content background.'
             }),
             foreground: lx.union([siteStandardThemeColor.json.id + '#rgb'], {
                 required: true,
-                description: 'Required color used for content text.'
+                description: 'Color used for content text.'
             }),
             accent: lx.union([siteStandardThemeColor.json.id + '#rgb'], {
                 required: true,
-                description: 'Required color used for links and button backgrounds.'
+                description: 'Color used for links and button backgrounds.'
             }),
             accentForeground: lx.union([siteStandardThemeColor.json.id + '#rgb'], {
                 required: true,
-                description: 'Required color used for button text.'
+                description: 'Color used for button text.'
             })
         }),
+        description: 'A simplified theme definition for publications, providing basic color customization for content display across different platforms and applications.'
     })
 })