Strip markdown from desc.

Author: dblock

.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-09-06 23:06:24 UTC using RuboCop version 1.80.2.
+# on 2025-09-06 23:33:08 UTC using RuboCop version 1.80.2.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -9,7 +9,7 @@
 # Offense count: 3
 # Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
 Metrics/AbcSize:
-  Max: 49
+  Max: 50
 
 # Offense count: 1
 # Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
@@ -20,7 +20,7 @@ Metrics/BlockLength:
 # Offense count: 1
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 115
+  Max: 127
 
 # Offense count: 2
 # Configuration parameters: AllowedMethods, AllowedPatterns.

methods/admin/admin.analytics.getFile.json

@@ -7,19 +7,19 @@
     "date": {
       "required": false,
       "example": "2020-09-01",
-      "desc": "Date to retrieve the analytics data for, expressed as `YYYY-MM-DD` in UTC. Required unless `metadata_only` is set to true.",
+      "desc": "Date to retrieve the analytics data for, expressed as YYYY-MM-DD in UTC. Required unless metadata_only is set to true.",
       "type": "date"
     },
     "metadata_only": {
       "required": false,
       "example": "true",
-      "desc": "Retrieve metadata for the `type` of analytics indicated. Can be used only with `type` set to `public_channel` analytics. See [detail below](#metadata_only). Omit the `date` parameter when using this argument.",
+      "desc": "Retrieve metadata for the type of analytics indicated. Can be used only with type set to public_channel analytics. See detail below. Omit the date parameter when using this argument.",
       "type": "boolean"
     },
     "type": {
       "required": true,
       "example": "member",
-      "desc": "The type of analytics to retrieve. The options are currently limited to `member` (for Enterprise org member analytics) and `public_channel` (for public channel analytics).",
+      "desc": "The type of analytics to retrieve. The options are currently limited to member (for Enterprise org member analytics) and public_channel (for public channel analytics).",
       "type": "string"
     }
   },

methods/admin/admin.apps.activities.list.json

@@ -12,19 +12,19 @@
     "component_id": {
       "required": false,
       "example": "Wf013SMGL4V9",
-      "desc": "The component ID of log events to be returned. Will be `FnXXXXXX` for functions, and `WfXXXXXX` for workflows.",
+      "desc": "The component ID of log events to be returned. Will be FnXXXXXX for functions, and WfXXXXXX for workflows.",
       "type": "string"
     },
     "component_type": {
       "required": false,
       "example": "workflows",
-      "desc": "The component type of log events to be returned. Acceptable values are `events_api`, `workflows`, `functions` and `tables`.",
+      "desc": "The component type of log events to be returned. Acceptable values are events_api, workflows, functions and tables.",
       "type": "string"
     },
     "cursor": {
       "required": false,
       "example": "bG9nX2lkOjc5NjQ1NA==",
-      "desc": "Paginate through collections of data by setting the `cursor` parameter to a `next_cursor` attribute returned by a previous request's `response_metadata`. See [pagination](/apis/web-api/pagination) for more detail.",
+      "desc": "Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. See pagination for more detail.",
       "type": "string"
     },
     "limit": {
@@ -54,7 +54,7 @@
     "min_log_level": {
       "required": false,
       "example": "info",
-      "desc": "The minimum log level of the log events to be returned. Defaults to `info`. Acceptable values (in order of relative importance from smallest to largest) are `trace`, `debug`, `info`, `warn`, `error` and `fatal`.",
+      "desc": "The minimum log level of the log events to be returned. Defaults to info. Acceptable values (in order of relative importance from smallest to largest) are trace, debug, info, warn, error and fatal.",
       "type": "string"
     },
     "sort_direction": {
@@ -66,7 +66,7 @@
     "source": {
       "required": false,
       "example": "slack",
-      "desc": "The source of log events to be returned. Acceptable values are `slack` and `developer`.",
+      "desc": "The source of log events to be returned. Acceptable values are slack and developer.",
       "type": "string"
     },
     "team_id": {

methods/admin/admin.apps.approved.list.json

@@ -13,12 +13,13 @@
     "cursor": {
       "required": false,
       "example": "5c3e53d5",
-      "desc": "Set `cursor` to `next_cursor` returned by the previous call to list items in the next page.",
+      "desc": "Set cursor to next_cursor returned by the previous call to list items in the next page.",
       "type": "string"
     },
     "enterprise_id": {
       "required": false,
-      "example": "E0AS553RN"
+      "example": "E0AS553RN",
+      "desc": ""
     },
     "limit": {
       "required": false,
@@ -28,7 +29,8 @@
     },
     "team_id": {
       "required": false,
-      "example": "T0HFE6EBT"
+      "example": "T0HFE6EBT",
+      "desc": ""
     }
   },
   "response": {

methods/admin/admin.apps.config.set.json

@@ -11,7 +11,7 @@
     },
     "domain_restrictions": {
       "required": false,
-      "desc": "Domain restrictions for the app. Should be an object with two properties: `urls` and `emails`. Each is an array of strings, and each sets the allowed URLs and emails for connector authorization, respectively.",
+      "desc": "Domain restrictions for the app. Should be an object with two properties: urls and emails. Each is an array of strings, and each sets the allowed URLs and emails for connector authorization, respectively.",
       "type": "object"
     },
     "rich_link_preview_type": {
@@ -21,7 +21,7 @@
     },
     "workflow_auth_strategy": {
       "required": false,
-      "desc": "The workflow auth permission. Can be one of `builder_choice` or `end_user_only`.",
+      "desc": "The workflow auth permission. Can be one of builder_choice or end_user_only.",
       "type": "enum"
     }
   },

methods/admin/admin.apps.requests.list.json

@@ -13,11 +13,12 @@
     "cursor": {
       "required": false,
       "example": "5c3e53d5",
-      "desc": "Set `cursor` to `next_cursor` returned by the previous call to list items in the next page.",
+      "desc": "Set cursor to next_cursor returned by the previous call to list items in the next page.",
       "type": "string"
     },
     "enterprise_id": {
-      "required": false
+      "required": false,
+      "desc": ""
     },
     "limit": {
       "required": false,
@@ -26,7 +27,8 @@
       "type": "integer"
     },
     "team_id": {
-      "required": false
+      "required": false,
+      "desc": ""
     }
   },
   "response": {

methods/admin/admin.apps.restricted.list.json

@@ -12,12 +12,13 @@
     "cursor": {
       "required": false,
       "example": "5c3e53d5",
-      "desc": "Set `cursor` to `next_cursor` returned by the previous call to list items in the next page.",
+      "desc": "Set cursor to next_cursor returned by the previous call to list items in the next page.",
       "type": "string"
     },
     "enterprise_id": {
       "required": false,
-      "example": "E0AS553RN"
+      "example": "E0AS553RN",
+      "desc": ""
     },
     "limit": {
       "required": false,
@@ -27,7 +28,8 @@
     },
     "team_id": {
       "required": false,
-      "example": "T0HFE6EBT"
+      "example": "T0HFE6EBT",
+      "desc": ""
     }
   },
   "response": {

methods/admin/admin.apps.uninstall.json

@@ -13,12 +13,12 @@
     "enterprise_id": {
       "required": false,
       "example": "E12345",
-      "desc": "The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or `team_ids` is required.",
+      "desc": "The enterprise to completely uninstall the application from (across all workspaces). With an org-level token, this or team_ids is required.",
       "type": "string"
     },
     "team_ids": {
       "required": false,
-      "desc": "IDs of the teams to uninstall from (max 100). With an org-level token, this or `enterprise_id` is required.",
+      "desc": "IDs of the teams to uninstall from (max 100). With an org-level token, this or enterprise_id is required.",
       "type": "string"
     }
   },

methods/admin/admin.auth.policy.assignEntities.json

@@ -12,12 +12,12 @@
     },
     "entity_type": {
       "required": true,
-      "desc": "The type of entity to assign to the policy. Currently, `USER` is supported."
+      "desc": "The type of entity to assign to the policy. Currently, USER is supported."
     },
     "policy_name": {
       "required": true,
       "example": "email_password",
-      "desc": "The name of the authentication policy to assign the entities to. Currently, `email_password` is the only policy that may be used with this method.",
+      "desc": "The name of the authentication policy to assign the entities to. Currently, email_password is the only policy that may be used with this method.",
       "type": "string"
     }
   },

methods/admin/admin.auth.policy.getEntities.json

@@ -7,12 +7,12 @@
     "cursor": {
       "required": false,
       "example": "5c3e53d5",
-      "desc": "Set `cursor` to `next_cursor` returned by the previous call to list items in the next page.",
+      "desc": "Set cursor to next_cursor returned by the previous call to list items in the next page.",
       "type": "string"
     },
     "entity_type": {
       "required": false,
-      "desc": "The type of entity to assign to the policy. Currently, `USER` is supported."
+      "desc": "The type of entity to assign to the policy. Currently, USER is supported."
     },
     "limit": {
       "required": false,
@@ -23,7 +23,7 @@
     "policy_name": {
       "required": true,
       "example": "email_password",
-      "desc": "The name of the policy to fetch entities for. Currently, `email_password` is the only policy that may be used with this method.",
+      "desc": "The name of the policy to fetch entities for. Currently, email_password is the only policy that may be used with this method.",
       "type": "string"
     }
   },