docs(web-api): align codeChannels.* docstrings with the API reference summaries

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Author: zimeg

slack_sdk/web/async_client.py

@@ -2120,7 +2120,7 @@ async def codeChannels_archive(
         summary_message_ts: Optional[str] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Archive a code channel, optionally recording a summary.
+        """Archives a code channel, optionally recording a summary message on the channel.
         https://docs.slack.dev/reference/methods/codeChannels.archive
         """
         kwargs.update({"channel_id": channel_id, "summary_message_ts": summary_message_ts})
@@ -2138,7 +2138,7 @@ async def codeChannels_create(
         origin_message_ts: Optional[str] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Create a code channel for a session.
+        """Creates a dedicated code channel for an agent session.
         https://docs.slack.dev/reference/methods/codeChannels.create
         """
         kwargs.update(
@@ -2163,7 +2163,7 @@ async def codeChannels_getCanvas(
         include_resolved: Optional[bool] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Read a code channel canvas's content and its comment threads.
+        """Fetches a canvas attached to a code channel — full content plus comment threads — in a single round-trip.
         https://docs.slack.dev/reference/methods/codeChannels.getCanvas
         """
         kwargs.update(
@@ -2183,7 +2183,7 @@ async def codeChannels_listViews(
         channel_id: str,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """List the view tabs attached to a code channel.
+        """Lists the views currently attached to a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.listViews
         """
         kwargs.update({"channel_id": channel_id})
@@ -2198,7 +2198,7 @@ async def codeChannels_removeView(
         view_id: Optional[str] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Remove a view tab from a code channel (provide exactly one of view_key or view_id).
+        """Removes a view from a code channel (provide exactly one of view_key or view_id).
         https://docs.slack.dev/reference/methods/codeChannels.removeView
         """
         kwargs.update({"channel_id": channel_id, "view_key": view_key, "view_id": view_id})
@@ -2212,7 +2212,7 @@ async def codeChannels_rename(
         name: str,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Rename a code channel.
+        """Renames a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.rename
         """
         kwargs.update({"channel_id": channel_id, "name": name})
@@ -2227,7 +2227,8 @@ async def codeChannels_setCanvasContent(
         content: str,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Replace a code channel canvas's content while preserving comment anchors.
+        """Replaces the full markdown content of a canvas attached to a code channel, preserving the
+        comment threads on the sections your agent didn't change.
         https://docs.slack.dev/reference/methods/codeChannels.setCanvasContent
         """
         kwargs.update({"channel_id": channel_id, "canvas_id": canvas_id, "content": content})
@@ -2241,7 +2242,7 @@ async def codeChannels_setCommands(
         commands: List[Dict[str, Any]],
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Register the agent's per-channel slash commands for a code channel.
+        """Registers the set of slash commands your agent offers in a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.setCommands
         """
         kwargs.update({"channel_id": channel_id, "commands": commands})
@@ -2256,7 +2257,7 @@ async def codeChannels_setProperties(
         agent_resource: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Set a code channel's context bar items and external resource details.
+        """Sets properties on a code channel: context bar items and external resource details.
         https://docs.slack.dev/reference/methods/codeChannels.setProperties
         """
         kwargs.update(
@@ -2286,7 +2287,8 @@ async def codeChannels_setView(
         csp: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> AsyncSlackResponse:
-        """Create or update a view tab (html, diff, block_kit, or canvas) on a code channel.
+        """Creates or updates a view in a code channel. Views can render HTML, diffs, Block Kit, or
+        canvases as tabs alongside the conversation.
         https://docs.slack.dev/reference/methods/codeChannels.setView
         """
         kwargs.update(

slack_sdk/web/client.py

@@ -2110,7 +2110,7 @@ def codeChannels_archive(
         summary_message_ts: Optional[str] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Archive a code channel, optionally recording a summary.
+        """Archives a code channel, optionally recording a summary message on the channel.
         https://docs.slack.dev/reference/methods/codeChannels.archive
         """
         kwargs.update({"channel_id": channel_id, "summary_message_ts": summary_message_ts})
@@ -2128,7 +2128,7 @@ def codeChannels_create(
         origin_message_ts: Optional[str] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Create a code channel for a session.
+        """Creates a dedicated code channel for an agent session.
         https://docs.slack.dev/reference/methods/codeChannels.create
         """
         kwargs.update(
@@ -2153,7 +2153,7 @@ def codeChannels_getCanvas(
         include_resolved: Optional[bool] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Read a code channel canvas's content and its comment threads.
+        """Fetches a canvas attached to a code channel — full content plus comment threads — in a single round-trip.
         https://docs.slack.dev/reference/methods/codeChannels.getCanvas
         """
         kwargs.update(
@@ -2173,7 +2173,7 @@ def codeChannels_listViews(
         channel_id: str,
         **kwargs,
     ) -> SlackResponse:
-        """List the view tabs attached to a code channel.
+        """Lists the views currently attached to a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.listViews
         """
         kwargs.update({"channel_id": channel_id})
@@ -2188,7 +2188,7 @@ def codeChannels_removeView(
         view_id: Optional[str] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Remove a view tab from a code channel (provide exactly one of view_key or view_id).
+        """Removes a view from a code channel (provide exactly one of view_key or view_id).
         https://docs.slack.dev/reference/methods/codeChannels.removeView
         """
         kwargs.update({"channel_id": channel_id, "view_key": view_key, "view_id": view_id})
@@ -2202,7 +2202,7 @@ def codeChannels_rename(
         name: str,
         **kwargs,
     ) -> SlackResponse:
-        """Rename a code channel.
+        """Renames a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.rename
         """
         kwargs.update({"channel_id": channel_id, "name": name})
@@ -2217,7 +2217,8 @@ def codeChannels_setCanvasContent(
         content: str,
         **kwargs,
     ) -> SlackResponse:
-        """Replace a code channel canvas's content while preserving comment anchors.
+        """Replaces the full markdown content of a canvas attached to a code channel, preserving the
+        comment threads on the sections your agent didn't change.
         https://docs.slack.dev/reference/methods/codeChannels.setCanvasContent
         """
         kwargs.update({"channel_id": channel_id, "canvas_id": canvas_id, "content": content})
@@ -2231,7 +2232,7 @@ def codeChannels_setCommands(
         commands: List[Dict[str, Any]],
         **kwargs,
     ) -> SlackResponse:
-        """Register the agent's per-channel slash commands for a code channel.
+        """Registers the set of slash commands your agent offers in a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.setCommands
         """
         kwargs.update({"channel_id": channel_id, "commands": commands})
@@ -2246,7 +2247,7 @@ def codeChannels_setProperties(
         agent_resource: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Set a code channel's context bar items and external resource details.
+        """Sets properties on a code channel: context bar items and external resource details.
         https://docs.slack.dev/reference/methods/codeChannels.setProperties
         """
         kwargs.update(
@@ -2276,7 +2277,8 @@ def codeChannels_setView(
         csp: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> SlackResponse:
-        """Create or update a view tab (html, diff, block_kit, or canvas) on a code channel.
+        """Creates or updates a view in a code channel. Views can render HTML, diffs, Block Kit, or
+        canvases as tabs alongside the conversation.
         https://docs.slack.dev/reference/methods/codeChannels.setView
         """
         kwargs.update(

slack_sdk/web/legacy_client.py

@@ -2121,7 +2121,7 @@ def codeChannels_archive(
         summary_message_ts: Optional[str] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Archive a code channel, optionally recording a summary.
+        """Archives a code channel, optionally recording a summary message on the channel.
         https://docs.slack.dev/reference/methods/codeChannels.archive
         """
         kwargs.update({"channel_id": channel_id, "summary_message_ts": summary_message_ts})
@@ -2139,7 +2139,7 @@ def codeChannels_create(
         origin_message_ts: Optional[str] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Create a code channel for a session.
+        """Creates a dedicated code channel for an agent session.
         https://docs.slack.dev/reference/methods/codeChannels.create
         """
         kwargs.update(
@@ -2164,7 +2164,7 @@ def codeChannels_getCanvas(
         include_resolved: Optional[bool] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Read a code channel canvas's content and its comment threads.
+        """Fetches a canvas attached to a code channel — full content plus comment threads — in a single round-trip.
         https://docs.slack.dev/reference/methods/codeChannels.getCanvas
         """
         kwargs.update(
@@ -2184,7 +2184,7 @@ def codeChannels_listViews(
         channel_id: str,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """List the view tabs attached to a code channel.
+        """Lists the views currently attached to a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.listViews
         """
         kwargs.update({"channel_id": channel_id})
@@ -2199,7 +2199,7 @@ def codeChannels_removeView(
         view_id: Optional[str] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Remove a view tab from a code channel (provide exactly one of view_key or view_id).
+        """Removes a view from a code channel (provide exactly one of view_key or view_id).
         https://docs.slack.dev/reference/methods/codeChannels.removeView
         """
         kwargs.update({"channel_id": channel_id, "view_key": view_key, "view_id": view_id})
@@ -2213,7 +2213,7 @@ def codeChannels_rename(
         name: str,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Rename a code channel.
+        """Renames a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.rename
         """
         kwargs.update({"channel_id": channel_id, "name": name})
@@ -2228,7 +2228,8 @@ def codeChannels_setCanvasContent(
         content: str,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Replace a code channel canvas's content while preserving comment anchors.
+        """Replaces the full markdown content of a canvas attached to a code channel, preserving the
+        comment threads on the sections your agent didn't change.
         https://docs.slack.dev/reference/methods/codeChannels.setCanvasContent
         """
         kwargs.update({"channel_id": channel_id, "canvas_id": canvas_id, "content": content})
@@ -2242,7 +2243,7 @@ def codeChannels_setCommands(
         commands: List[Dict[str, Any]],
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Register the agent's per-channel slash commands for a code channel.
+        """Registers the set of slash commands your agent offers in a code channel.
         https://docs.slack.dev/reference/methods/codeChannels.setCommands
         """
         kwargs.update({"channel_id": channel_id, "commands": commands})
@@ -2257,7 +2258,7 @@ def codeChannels_setProperties(
         agent_resource: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Set a code channel's context bar items and external resource details.
+        """Sets properties on a code channel: context bar items and external resource details.
         https://docs.slack.dev/reference/methods/codeChannels.setProperties
         """
         kwargs.update(
@@ -2287,7 +2288,8 @@ def codeChannels_setView(
         csp: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> Union[Future, SlackResponse]:
-        """Create or update a view tab (html, diff, block_kit, or canvas) on a code channel.
+        """Creates or updates a view in a code channel. Views can render HTML, diffs, Block Kit, or
+        canvases as tabs alongside the conversation.
         https://docs.slack.dev/reference/methods/codeChannels.setView
         """
         kwargs.update(