diff --git a/lexicons/com/atproto/identity/resolveHandle.json b/lexicons/com/atproto/identity/resolveHandle.json
index ae5aab8f8fc..95885088a7b 100644
--- a/lexicons/com/atproto/identity/resolveHandle.json
+++ b/lexicons/com/atproto/identity/resolveHandle.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Provides the DID of a repo.",
+      "description": "Resolves a handle (domain name) to a DID.",
       "parameters": {
         "type": "params",
         "required": ["handle"],
diff --git a/lexicons/com/atproto/identity/updateHandle.json b/lexicons/com/atproto/identity/updateHandle.json
index 5fe392bb838..9bb5c347d38 100644
--- a/lexicons/com/atproto/identity/updateHandle.json
+++ b/lexicons/com/atproto/identity/updateHandle.json
@@ -4,14 +4,18 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Updates the handle of the account.",
+      "description": "Updates the current account's handle. Verifies handle validity, and updates did:plc document if necessary. Implemented by PDS, and requires auth.",
       "input": {
         "encoding": "application/json",
         "schema": {
           "type": "object",
           "required": ["handle"],
           "properties": {
-            "handle": { "type": "string", "format": "handle" }
+            "handle": {
+              "type": "string",
+              "format": "handle",
+              "description": "The new handle."
+            }
           }
         }
       }
diff --git a/lexicons/com/atproto/label/queryLabels.json b/lexicons/com/atproto/label/queryLabels.json
index 7b6fbe23d54..6c81cb0bba6 100644
--- a/lexicons/com/atproto/label/queryLabels.json
+++ b/lexicons/com/atproto/label/queryLabels.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Find labels relevant to the provided URI patterns.",
+      "description": "Find labels relevant to the provided AT-URI patterns. Public endpoint for moderation services, though may return different or additional results with auth.",
       "parameters": {
         "type": "params",
         "required": ["uriPatterns"],
diff --git a/lexicons/com/atproto/label/subscribeLabels.json b/lexicons/com/atproto/label/subscribeLabels.json
index 9813ffc192e..5fb1a852d3d 100644
--- a/lexicons/com/atproto/label/subscribeLabels.json
+++ b/lexicons/com/atproto/label/subscribeLabels.json
@@ -4,13 +4,13 @@
   "defs": {
     "main": {
       "type": "subscription",
-      "description": "Subscribe to label updates.",
+      "description": "Subscribe to stream of labels (and negations). Public endpoint implemented by mod services. Uses same sequencing scheme as repo event stream.",
       "parameters": {
         "type": "params",
         "properties": {
           "cursor": {
             "type": "integer",
-            "description": "The last known event to backfill from."
+            "description": "The last known event seq number to backfill from."
           }
         }
       },
diff --git a/lexicons/com/atproto/moderation/createReport.json b/lexicons/com/atproto/moderation/createReport.json
index 161d622fcf2..f41d28d0b15 100644
--- a/lexicons/com/atproto/moderation/createReport.json
+++ b/lexicons/com/atproto/moderation/createReport.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Report a repo or a record.",
+      "description": "Submit a moderation report regarding an atproto account or record. Implemented by moderation services (with PDS proxying), and requires auth.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -13,9 +13,13 @@
           "properties": {
             "reasonType": {
               "type": "ref",
+              "description": "Indicates the broad category of violation the report is for.",
               "ref": "com.atproto.moderation.defs#reasonType"
             },
-            "reason": { "type": "string" },
+            "reason": {
+              "type": "string",
+              "description": "Additional context about the content and violation."
+            },
             "subject": {
               "type": "union",
               "refs": [
diff --git a/lexicons/com/atproto/repo/applyWrites.json b/lexicons/com/atproto/repo/applyWrites.json
index 050b6efbfab..427fc84c4a5 100644
--- a/lexicons/com/atproto/repo/applyWrites.json
+++ b/lexicons/com/atproto/repo/applyWrites.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Apply a batch transaction of creates, updates, and deletes.",
+      "description": "Apply a batch transaction of repository creates, updates, and deletes. Requires auth, implemented by PDS.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -14,12 +14,12 @@
             "repo": {
               "type": "string",
               "format": "at-identifier",
-              "description": "The handle or DID of the repo."
+              "description": "The handle or DID of the repo (aka, current account)."
             },
             "validate": {
               "type": "boolean",
               "default": true,
-              "description": "Flag for validating the records."
+              "description": "Can be set to 'false' to skip Lexicon schema validation of record data, for all operations."
             },
             "writes": {
               "type": "array",
@@ -31,16 +31,22 @@
             },
             "swapCommit": {
               "type": "string",
+              "description": "If provided, the entire operation will fail if the current repo commit CID does not match this value. Used to prevent conflicting repo mutations.",
               "format": "cid"
             }
           }
         }
       },
-      "errors": [{ "name": "InvalidSwap" }]
+      "errors": [
+        {
+          "name": "InvalidSwap",
+          "description": "Indicates that the 'swapCommit' parameter did not match current commit."
+        }
+      ]
     },
     "create": {
       "type": "object",
-      "description": "Create a new record.",
+      "description": "Operation which creates a new record.",
       "required": ["collection", "value"],
       "properties": {
         "collection": { "type": "string", "format": "nsid" },
@@ -50,7 +56,7 @@
     },
     "update": {
       "type": "object",
-      "description": "Update an existing record.",
+      "description": "Operation which updates an existing record.",
       "required": ["collection", "rkey", "value"],
       "properties": {
         "collection": { "type": "string", "format": "nsid" },
@@ -60,7 +66,7 @@
     },
     "delete": {
       "type": "object",
-      "description": "Delete an existing record.",
+      "description": "Operation which deletes an existing record.",
       "required": ["collection", "rkey"],
       "properties": {
         "collection": { "type": "string", "format": "nsid" },
diff --git a/lexicons/com/atproto/repo/createRecord.json b/lexicons/com/atproto/repo/createRecord.json
index baef20c88f0..185f5250850 100644
--- a/lexicons/com/atproto/repo/createRecord.json
+++ b/lexicons/com/atproto/repo/createRecord.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Create a new record.",
+      "description": "Create a single new repository record. Requires auth, implemented by PDS.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -14,7 +14,7 @@
             "repo": {
               "type": "string",
               "format": "at-identifier",
-              "description": "The handle or DID of the repo."
+              "description": "The handle or DID of the repo (aka, current account)."
             },
             "collection": {
               "type": "string",
@@ -23,17 +23,17 @@
             },
             "rkey": {
               "type": "string",
-              "description": "The key of the record.",
+              "description": "The Record Key.",
               "maxLength": 15
             },
             "validate": {
               "type": "boolean",
               "default": true,
-              "description": "Flag for validating the record."
+              "description": "Can be set to 'false' to skip Lexicon schema validation of record data."
             },
             "record": {
               "type": "unknown",
-              "description": "The record to create."
+              "description": "The record itself. Must contain a $type field."
             },
             "swapCommit": {
               "type": "string",
@@ -54,7 +54,12 @@
           }
         }
       },
-      "errors": [{ "name": "InvalidSwap" }]
+      "errors": [
+        {
+          "name": "InvalidSwap",
+          "description": "Indicates that 'swapCommit' didn't match current repo commit."
+        }
+      ]
     }
   }
 }
diff --git a/lexicons/com/atproto/repo/deleteRecord.json b/lexicons/com/atproto/repo/deleteRecord.json
index d8d7955b6a9..65b9f8f9536 100644
--- a/lexicons/com/atproto/repo/deleteRecord.json
+++ b/lexicons/com/atproto/repo/deleteRecord.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Delete a record, or ensure it doesn't exist.",
+      "description": "Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -14,7 +14,7 @@
             "repo": {
               "type": "string",
               "format": "at-identifier",
-              "description": "The handle or DID of the repo."
+              "description": "The handle or DID of the repo (aka, current account)."
             },
             "collection": {
               "type": "string",
@@ -23,7 +23,7 @@
             },
             "rkey": {
               "type": "string",
-              "description": "The key of the record."
+              "description": "The Record Key."
             },
             "swapRecord": {
               "type": "string",
diff --git a/lexicons/com/atproto/repo/describeRepo.json b/lexicons/com/atproto/repo/describeRepo.json
index b7f283bff70..b1ce2b6cf9e 100644
--- a/lexicons/com/atproto/repo/describeRepo.json
+++ b/lexicons/com/atproto/repo/describeRepo.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get information about the repo, including the list of collections.",
+      "description": "Get information about an account and repository, including the list of collections. Does not require auth.",
       "parameters": {
         "type": "params",
         "required": ["repo"],
@@ -30,12 +30,19 @@
           "properties": {
             "handle": { "type": "string", "format": "handle" },
             "did": { "type": "string", "format": "did" },
-            "didDoc": { "type": "unknown" },
+            "didDoc": {
+              "type": "unknown",
+              "description": "The complete DID document for this account."
+            },
             "collections": {
               "type": "array",
+              "description": "List of all the collections (NSIDs) for which this repo contains at least one record.",
               "items": { "type": "string", "format": "nsid" }
             },
-            "handleIsCorrect": { "type": "boolean" }
+            "handleIsCorrect": {
+              "type": "boolean",
+              "description": "Indicates if handle is currently valid (resolves bi-directionally)"
+            }
           }
         }
       }
diff --git a/lexicons/com/atproto/repo/getRecord.json b/lexicons/com/atproto/repo/getRecord.json
index ec4d17e4260..5d8bb173470 100644
--- a/lexicons/com/atproto/repo/getRecord.json
+++ b/lexicons/com/atproto/repo/getRecord.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get a record.",
+      "description": "Get a single record from a repository. Does not require auth.",
       "parameters": {
         "type": "params",
         "required": ["repo", "collection", "rkey"],
@@ -19,7 +19,7 @@
             "format": "nsid",
             "description": "The NSID of the record collection."
           },
-          "rkey": { "type": "string", "description": "The key of the record." },
+          "rkey": { "type": "string", "description": "The Record Key." },
           "cid": {
             "type": "string",
             "format": "cid",
diff --git a/lexicons/com/atproto/repo/listRecords.json b/lexicons/com/atproto/repo/listRecords.json
index ac04e3e8782..bc91c952bb1 100644
--- a/lexicons/com/atproto/repo/listRecords.json
+++ b/lexicons/com/atproto/repo/listRecords.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List a range of records in a collection.",
+      "description": "List a range of records in a repository, matching a specific collection. Does not require auth.",
       "parameters": {
         "type": "params",
         "required": ["repo", "collection"],
diff --git a/lexicons/com/atproto/repo/putRecord.json b/lexicons/com/atproto/repo/putRecord.json
index ae39bd95ead..51f11c0f13f 100644
--- a/lexicons/com/atproto/repo/putRecord.json
+++ b/lexicons/com/atproto/repo/putRecord.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Write a record, creating or updating it as needed.",
+      "description": "Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -15,7 +15,7 @@
             "repo": {
               "type": "string",
               "format": "at-identifier",
-              "description": "The handle or DID of the repo."
+              "description": "The handle or DID of the repo (aka, current account)."
             },
             "collection": {
               "type": "string",
@@ -24,13 +24,13 @@
             },
             "rkey": {
               "type": "string",
-              "description": "The key of the record.",
+              "description": "The Record Key.",
               "maxLength": 15
             },
             "validate": {
               "type": "boolean",
               "default": true,
-              "description": "Flag for validating the record."
+              "description": "Can be set to 'false' to skip Lexicon schema validation of record data."
             },
             "record": {
               "type": "unknown",
@@ -39,7 +39,7 @@
             "swapRecord": {
               "type": "string",
               "format": "cid",
-              "description": "Compare and swap with the previous record by CID."
+              "description": "Compare and swap with the previous record by CID. WARNING: nullable and optional field; may cause problems with golang implementation"
             },
             "swapCommit": {
               "type": "string",
diff --git a/lexicons/com/atproto/repo/uploadBlob.json b/lexicons/com/atproto/repo/uploadBlob.json
index 63d1671bd3e..547a995a051 100644
--- a/lexicons/com/atproto/repo/uploadBlob.json
+++ b/lexicons/com/atproto/repo/uploadBlob.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Upload a new blob to be added to repo in a later request.",
+      "description": "Upload a new blob, to be referenced from a repository record. The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created. Requires auth, implemented by PDS.",
       "input": {
         "encoding": "*/*"
       },
diff --git a/lexicons/com/atproto/server/createAccount.json b/lexicons/com/atproto/server/createAccount.json
index d1456e095ae..b32bbe1569d 100644
--- a/lexicons/com/atproto/server/createAccount.json
+++ b/lexicons/com/atproto/server/createAccount.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Create an account.",
+      "description": "Create an account. Implemented by PDS.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -12,14 +12,31 @@
           "required": ["handle"],
           "properties": {
             "email": { "type": "string" },
-            "handle": { "type": "string", "format": "handle" },
-            "did": { "type": "string", "format": "did" },
+            "handle": {
+              "type": "string",
+              "format": "handle",
+              "description": "Requested handle for the account."
+            },
+            "did": {
+              "type": "string",
+              "format": "did",
+              "description": "Pre-existing atproto DID, being imported to a new account."
+            },
             "inviteCode": { "type": "string" },
             "verificationCode": { "type": "string" },
             "verificationPhone": { "type": "string" },
-            "password": { "type": "string" },
-            "recoveryKey": { "type": "string" },
-            "plcOp": { "type": "unknown" }
+            "password": {
+              "type": "string",
+              "description": "Initial account password. May need to meet instance-specific password strength requirements."
+            },
+            "recoveryKey": {
+              "type": "string",
+              "description": "DID PLC rotation key (aka, recovery key) to be included in PLC creation operation."
+            },
+            "plcOp": {
+              "type": "unknown",
+              "description": "A signed DID PLC operation to be submitted as part of importing an existing account to this instance. NOTE: this optional field may be updated when full account migration is implemented."
+            }
           }
         }
       },
@@ -27,13 +44,21 @@
         "encoding": "application/json",
         "schema": {
           "type": "object",
+          "description": "Account login session returned on successful account creation.",
           "required": ["accessJwt", "refreshJwt", "handle", "did"],
           "properties": {
             "accessJwt": { "type": "string" },
             "refreshJwt": { "type": "string" },
             "handle": { "type": "string", "format": "handle" },
-            "did": { "type": "string", "format": "did" },
-            "didDoc": { "type": "unknown" }
+            "did": {
+              "type": "string",
+              "format": "did",
+              "description": "The DID of the new account."
+            },
+            "didDoc": {
+              "type": "unknown",
+              "description": "Complete DID document."
+            }
           }
         }
       },
diff --git a/lexicons/com/atproto/server/createAppPassword.json b/lexicons/com/atproto/server/createAppPassword.json
index f12e8e2557e..0a60e4e30b0 100644
--- a/lexicons/com/atproto/server/createAppPassword.json
+++ b/lexicons/com/atproto/server/createAppPassword.json
@@ -11,7 +11,10 @@
           "type": "object",
           "required": ["name"],
           "properties": {
-            "name": { "type": "string" }
+            "name": {
+              "type": "string",
+              "description": "A short name for the App Password, to help distinguish them."
+            }
           }
         }
       },
diff --git a/lexicons/com/atproto/server/deleteAccount.json b/lexicons/com/atproto/server/deleteAccount.json
index 3747189dca3..cf4babfe7da 100644
--- a/lexicons/com/atproto/server/deleteAccount.json
+++ b/lexicons/com/atproto/server/deleteAccount.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Delete an actor's account with a token and password.",
+      "description": "Delete an actor's account with a token and password. Can only be called after requesting a deletion token. Requires auth.",
       "input": {
         "encoding": "application/json",
         "schema": {
diff --git a/lexicons/com/atproto/server/deleteSession.json b/lexicons/com/atproto/server/deleteSession.json
index e05d019024a..807a89dc9bd 100644
--- a/lexicons/com/atproto/server/deleteSession.json
+++ b/lexicons/com/atproto/server/deleteSession.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Delete the current session."
+      "description": "Delete the current session. Requires auth."
     }
   }
 }
diff --git a/lexicons/com/atproto/server/describeServer.json b/lexicons/com/atproto/server/describeServer.json
index 3c60a58ecaf..908cb2127f9 100644
--- a/lexicons/com/atproto/server/describeServer.json
+++ b/lexicons/com/atproto/server/describeServer.json
@@ -4,20 +4,31 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get a document describing the service's accounts configuration.",
+      "description": "Describes the server's account creation requirements and capabilities. Implemented by PDS.",
       "output": {
         "encoding": "application/json",
         "schema": {
           "type": "object",
           "required": ["availableUserDomains"],
           "properties": {
-            "inviteCodeRequired": { "type": "boolean" },
-            "phoneVerificationRequired": { "type": "boolean" },
+            "inviteCodeRequired": {
+              "type": "boolean",
+              "description": "If true, an invite code must be supplied to create an account on this instance."
+            },
+            "phoneVerificationRequired": {
+              "type": "boolean",
+              "description": "If true, a phone verification token must be supplied to create an account on this instance."
+            },
             "availableUserDomains": {
               "type": "array",
+              "description": "List of domain suffixes that can be used in account handles.",
               "items": { "type": "string" }
             },
-            "links": { "type": "ref", "ref": "#links" }
+            "links": {
+              "type": "ref",
+              "description": "URLs of service policy documents.",
+              "ref": "#links"
+            }
           }
         }
       }
diff --git a/lexicons/com/atproto/server/getAccountInviteCodes.json b/lexicons/com/atproto/server/getAccountInviteCodes.json
index ac23b11f23f..72f0822703d 100644
--- a/lexicons/com/atproto/server/getAccountInviteCodes.json
+++ b/lexicons/com/atproto/server/getAccountInviteCodes.json
@@ -4,12 +4,16 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get all invite codes for a given account.",
+      "description": "Get all invite codes for the current account. Requires auth.",
       "parameters": {
         "type": "params",
         "properties": {
           "includeUsed": { "type": "boolean", "default": true },
-          "createAvailable": { "type": "boolean", "default": true }
+          "createAvailable": {
+            "type": "boolean",
+            "default": true,
+            "description": "Controls whether any new 'earned' but not 'created' invites should be created."
+          }
         }
       },
       "output": {
diff --git a/lexicons/com/atproto/server/getSession.json b/lexicons/com/atproto/server/getSession.json
index 5f7700882da..6b5f280e746 100644
--- a/lexicons/com/atproto/server/getSession.json
+++ b/lexicons/com/atproto/server/getSession.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get information about the current session.",
+      "description": "Get information about the current auth session. Requires auth.",
       "output": {
         "encoding": "application/json",
         "schema": {
diff --git a/lexicons/com/atproto/server/refreshSession.json b/lexicons/com/atproto/server/refreshSession.json
index 3f4d7fdf272..0b067f86b7f 100644
--- a/lexicons/com/atproto/server/refreshSession.json
+++ b/lexicons/com/atproto/server/refreshSession.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Refresh an authentication session.",
+      "description": "Refresh an authentication session. Requires auth using the 'refreshJwt' (not the 'accessJwt').",
       "output": {
         "encoding": "application/json",
         "schema": {
diff --git a/lexicons/com/atproto/server/reserveSigningKey.json b/lexicons/com/atproto/server/reserveSigningKey.json
index 3a67ad0a3c8..4a99a34528b 100644
--- a/lexicons/com/atproto/server/reserveSigningKey.json
+++ b/lexicons/com/atproto/server/reserveSigningKey.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Reserve a repo signing key for account creation.",
+      "description": "Reserve a repo signing key, for use with account creation. Necessary so that a DID PLC update operation can be constructed during an account migraiton. Public and does not require auth; implemented by PDS. NOTE: this endpoint may change when full account migration is implemented.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -12,7 +12,7 @@
           "properties": {
             "did": {
               "type": "string",
-              "description": "The did to reserve a new did:key for"
+              "description": "The DID to reserve a key for."
             }
           }
         }
@@ -25,7 +25,7 @@
           "properties": {
             "signingKey": {
               "type": "string",
-              "description": "Public signing key in the form of a did:key."
+              "description": "The public key for the reserved signing key, in did:key serialization."
             }
           }
         }
diff --git a/lexicons/com/atproto/sync/getBlob.json b/lexicons/com/atproto/sync/getBlob.json
index 23e18a4f3b5..57ece7a9d8a 100644
--- a/lexicons/com/atproto/sync/getBlob.json
+++ b/lexicons/com/atproto/sync/getBlob.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get a blob associated with a given repo.",
+      "description": "Get a blob associated with a given account. Returns the full blob as originally uploaded. Does not require auth; implemented by PDS.",
       "parameters": {
         "type": "params",
         "required": ["did", "cid"],
@@ -12,7 +12,7 @@
           "did": {
             "type": "string",
             "format": "did",
-            "description": "The DID of the repo."
+            "description": "The DID of the account."
           },
           "cid": {
             "type": "string",
diff --git a/lexicons/com/atproto/sync/getBlocks.json b/lexicons/com/atproto/sync/getBlocks.json
index cf776a0c88f..29dd4971904 100644
--- a/lexicons/com/atproto/sync/getBlocks.json
+++ b/lexicons/com/atproto/sync/getBlocks.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get blocks from a given repo.",
+      "description": "Get data blocks from a given repo, by CID. For example, intermediate MST nodes, or records. Does not require auth; implemented by PDS.",
       "parameters": {
         "type": "params",
         "required": ["did", "cids"],
diff --git a/lexicons/com/atproto/sync/getLatestCommit.json b/lexicons/com/atproto/sync/getLatestCommit.json
index d8754f09062..ac7faf57570 100644
--- a/lexicons/com/atproto/sync/getLatestCommit.json
+++ b/lexicons/com/atproto/sync/getLatestCommit.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get the current commit CID & revision of the repo.",
+      "description": "Get the current commit CID & revision of the specified repo. Does not require auth.",
       "parameters": {
         "type": "params",
         "required": ["did"],
diff --git a/lexicons/com/atproto/sync/getRecord.json b/lexicons/com/atproto/sync/getRecord.json
index cbd0ad3a5ac..718245a5195 100644
--- a/lexicons/com/atproto/sync/getRecord.json
+++ b/lexicons/com/atproto/sync/getRecord.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Get blocks needed for existence or non-existence of record.",
+      "description": "Get data blocks needed to prove the existence or non-existence of record in the current version of repo. Does not require auth.",
       "parameters": {
         "type": "params",
         "required": ["did", "collection", "rkey"],
@@ -15,7 +15,7 @@
             "description": "The DID of the repo."
           },
           "collection": { "type": "string", "format": "nsid" },
-          "rkey": { "type": "string" },
+          "rkey": { "type": "string", "description": "Record Key" },
           "commit": {
             "type": "string",
             "format": "cid",
diff --git a/lexicons/com/atproto/sync/getRepo.json b/lexicons/com/atproto/sync/getRepo.json
index fb68ab670ee..7fa710abfb5 100644
--- a/lexicons/com/atproto/sync/getRepo.json
+++ b/lexicons/com/atproto/sync/getRepo.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Gets the DID's repo, optionally catching up from a specific revision.",
+      "description": "Download a repository export as CAR file. Optionally only a 'diff' since a previous revision. Does not require auth; implemented by PDS.",
       "parameters": {
         "type": "params",
         "required": ["did"],
@@ -16,7 +16,7 @@
           },
           "since": {
             "type": "string",
-            "description": "The revision of the repo to catch up from."
+            "description": "The revision ('rev') of the repo to create a diff from."
           }
         }
       },
diff --git a/lexicons/com/atproto/sync/listBlobs.json b/lexicons/com/atproto/sync/listBlobs.json
index 46815eeb49a..b4c954d999a 100644
--- a/lexicons/com/atproto/sync/listBlobs.json
+++ b/lexicons/com/atproto/sync/listBlobs.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List blob CIDs since some revision.",
+      "description": "List blob CIDso for an account, since some repo revision. Does not require auth; implemented by PDS.",
       "parameters": {
         "type": "params",
         "required": ["did"],
diff --git a/lexicons/com/atproto/sync/listRepos.json b/lexicons/com/atproto/sync/listRepos.json
index 440e8693d5e..07ae35e2c5e 100644
--- a/lexicons/com/atproto/sync/listRepos.json
+++ b/lexicons/com/atproto/sync/listRepos.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "List DIDs and root CIDs of hosted repos.",
+      "description": "Enumerates all the DID, rev, and commit CID for all repos hosted by this service. Does not require auth; implemented by PDS and Relay.",
       "parameters": {
         "type": "params",
         "properties": {
@@ -37,7 +37,11 @@
       "required": ["did", "head", "rev"],
       "properties": {
         "did": { "type": "string", "format": "did" },
-        "head": { "type": "string", "format": "cid" },
+        "head": {
+          "type": "string",
+          "format": "cid",
+          "description": "Current repo commit CID"
+        },
         "rev": { "type": "string" }
       }
     }
diff --git a/lexicons/com/atproto/sync/notifyOfUpdate.json b/lexicons/com/atproto/sync/notifyOfUpdate.json
index 48cb4b24678..034a9655a08 100644
--- a/lexicons/com/atproto/sync/notifyOfUpdate.json
+++ b/lexicons/com/atproto/sync/notifyOfUpdate.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Notify a crawling service of a recent update; often when a long break between updates causes the connection with the crawling service to break.",
+      "description": "Notify a crawling service of a recent update, and that crawling should resume. Intended use is after a gap between repo stream events caused the crawling service to disconnect. Does not require auth; implemented by Relay.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -13,7 +13,7 @@
           "properties": {
             "hostname": {
               "type": "string",
-              "description": "Hostname of the service that is notifying of update."
+              "description": "Hostname of the current service (usually a PDS) that is notifying of update."
             }
           }
         }
diff --git a/lexicons/com/atproto/sync/requestCrawl.json b/lexicons/com/atproto/sync/requestCrawl.json
index a3520a33180..8e075a376fc 100644
--- a/lexicons/com/atproto/sync/requestCrawl.json
+++ b/lexicons/com/atproto/sync/requestCrawl.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Request a service to persistently crawl hosted repos.",
+      "description": "Request a service to persistently crawl hosted repos. Expected use is new PDS instances declaring their existence to Relays. Does not require auth.",
       "input": {
         "encoding": "application/json",
         "schema": {
@@ -13,7 +13,7 @@
           "properties": {
             "hostname": {
               "type": "string",
-              "description": "Hostname of the service that is requesting to be crawled."
+              "description": "Hostname of the current service (eg, PDS) that is requesting to be crawled."
             }
           }
         }
diff --git a/lexicons/com/atproto/sync/subscribeRepos.json b/lexicons/com/atproto/sync/subscribeRepos.json
index 9a5c0f6153c..73a34a3b49e 100644
--- a/lexicons/com/atproto/sync/subscribeRepos.json
+++ b/lexicons/com/atproto/sync/subscribeRepos.json
@@ -4,13 +4,13 @@
   "defs": {
     "main": {
       "type": "subscription",
-      "description": "Subscribe to repo updates.",
+      "description": "Repository event stream, aka Firehose endpoint. Outputs repo commits with diff data, and identity update events, for all repositories on the current server. See the atproto specifications for details around stream sequencing, repo versioning, CAR diff format, and more. Public and does not require auth; implemented by PDS and Relay.",
       "parameters": {
         "type": "params",
         "properties": {
           "cursor": {
             "type": "integer",
-            "description": "The last known event to backfill from."
+            "description": "The last known event seq number to backfill from."
           }
         }
       },
@@ -20,10 +20,17 @@
           "refs": ["#commit", "#handle", "#migrate", "#tombstone", "#info"]
         }
       },
-      "errors": [{ "name": "FutureCursor" }, { "name": "ConsumerTooSlow" }]
+      "errors": [
+        { "name": "FutureCursor" },
+        {
+          "name": "ConsumerTooSlow",
+          "description": "If the consumer of the stream can not keep up with events, and a backlog gets too large, the server will drop the connection."
+        }
+      ]
     },
     "commit": {
       "type": "object",
+      "description": "Represents an update of repository state. Note that empty commits are allowed, which include no repo data changes, but an update to rev and signature.",
       "required": [
         "seq",
         "rebase",
@@ -39,39 +46,67 @@
       ],
       "nullable": ["prev", "since"],
       "properties": {
-        "seq": { "type": "integer" },
-        "rebase": { "type": "boolean" },
-        "tooBig": { "type": "boolean" },
-        "repo": { "type": "string", "format": "did" },
-        "commit": { "type": "cid-link" },
-        "prev": { "type": "cid-link" },
+        "seq": {
+          "type": "integer",
+          "description": "The stream sequence number of this message."
+        },
+        "rebase": { "type": "boolean", "description": "DEPRECATED -- unused" },
+        "tooBig": {
+          "type": "boolean",
+          "description": "Indicates that this commit contained too many ops, or data size was too large. Consumers will need to make a separate request to get missing data."
+        },
+        "repo": {
+          "type": "string",
+          "format": "did",
+          "description": "The repo this event comes from."
+        },
+        "commit": {
+          "type": "cid-link",
+          "description": "Repo commit object CID."
+        },
+        "prev": {
+          "type": "cid-link",
+          "description": "DEPRECATED -- unused. WARNING -- nullable and optional; stick with optional to ensure golang interoperability."
+        },
         "rev": {
           "type": "string",
-          "description": "The rev of the emitted commit."
+          "description": "The rev of the emitted commit. Note that this information is also in the commit object included in blocks, unless this is a tooBig event."
         },
         "since": {
           "type": "string",
-          "description": "The rev of the last emitted commit from this repo."
+          "description": "The rev of the last emitted commit from this repo (if any)."
         },
         "blocks": {
           "type": "bytes",
-          "description": "CAR file containing relevant blocks.",
+          "description": "CAR file containing relevant blocks, as a diff since the previous repo state.",
           "maxLength": 1000000
         },
         "ops": {
           "type": "array",
-          "items": { "type": "ref", "ref": "#repoOp" },
+          "items": {
+            "type": "ref",
+            "ref": "#repoOp",
+            "description": "List of repo mutation operations in this commit (eg, records created, updated, or deleted)."
+          },
           "maxLength": 200
         },
         "blobs": {
           "type": "array",
-          "items": { "type": "cid-link" }
+          "items": {
+            "type": "cid-link",
+            "description": "List of new blobs (by CID) referenced by records in this commit."
+          }
         },
-        "time": { "type": "string", "format": "datetime" }
+        "time": {
+          "type": "string",
+          "format": "datetime",
+          "description": "Timestamp of when this message was originally broadcast."
+        }
       }
     },
     "handle": {
       "type": "object",
+      "description": "Represents an update of the account's handle, or transition to/from invalid state.",
       "required": ["seq", "did", "handle", "time"],
       "properties": {
         "seq": { "type": "integer" },
@@ -82,6 +117,7 @@
     },
     "migrate": {
       "type": "object",
+      "description": "Represents an account moving from one PDS instance to another. NOTE: not implemented; full account migration may introduce a new message instead.",
       "required": ["seq", "did", "migrateTo", "time"],
       "nullable": ["migrateTo"],
       "properties": {
@@ -93,6 +129,7 @@
     },
     "tombstone": {
       "type": "object",
+      "description": "Indicates that an account has been deleted.",
       "required": ["seq", "did", "time"],
       "properties": {
         "seq": { "type": "integer" },
@@ -115,7 +152,7 @@
     },
     "repoOp": {
       "type": "object",
-      "description": "A repo operation, ie a write of a single record. For creates and updates, CID is the record's CID as of this operation. For deletes, it's null.",
+      "description": "A repo operation, ie a mutation of a single record.",
       "required": ["action", "path", "cid"],
       "nullable": ["cid"],
       "properties": {
@@ -124,7 +161,10 @@
           "knownValues": ["create", "update", "delete"]
         },
         "path": { "type": "string" },
-        "cid": { "type": "cid-link" }
+        "cid": {
+          "type": "cid-link",
+          "description": "For creates and updates, the new record CID. For deletions, null."
+        }
       }
     }
   }
diff --git a/lexicons/com/atproto/temp/fetchLabels.json b/lexicons/com/atproto/temp/fetchLabels.json
index 14e392fd5e7..d76041ac296 100644
--- a/lexicons/com/atproto/temp/fetchLabels.json
+++ b/lexicons/com/atproto/temp/fetchLabels.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "query",
-      "description": "Fetch all labels from a labeler created after a certain date.",
+      "description": "Fetch all labels from a labeler created after a certain date. DEPRECATED: use queryLabels or subscribeLabels instead",
       "parameters": {
         "type": "params",
         "properties": {
diff --git a/lexicons/com/atproto/temp/transferAccount.json b/lexicons/com/atproto/temp/transferAccount.json
index 3cb2035ac0e..d4687d9b6e1 100644
--- a/lexicons/com/atproto/temp/transferAccount.json
+++ b/lexicons/com/atproto/temp/transferAccount.json
@@ -4,7 +4,7 @@
   "defs": {
     "main": {
       "type": "procedure",
-      "description": "Transfer an account.",
+      "description": "Transfer an account. NOTE: temporary method, necessarily how account migration will be implemented.",
       "input": {
         "encoding": "application/json",
         "schema": {