fix: correct docstring content defects left by the pydocstyle sweep

The ruff pydocstyle (D) reformatting enforced docstring shape but not
content, leaving six correctness/consistency defects:

- falcon/resource.py: reformatting turned the usage snippet into an
  invalid example (`app = App().`); restore a proper summary + clean code
- socket_mode base_handler.py / async_base_handler.py: summary split mid
  sentence left a dangling lowercase fragment; merge it back
- __init__.py: "features.Read" was missing a space (shown on PyPI)
- async_app.py dialog_cancellation: summary wrongly said dialog_submission
- app.py / async_app.py step(): de-indent the orphaned Deprecated block
- async_authorize.py: add backticks around `authorize` to mirror the sync
  CallableAuthorize docstring

Docstring-only; no behavior change. Sync/async pairs kept mirrored.

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

Author: WilliamBergamin

slack_bolt/__init__.py

@@ -1,4 +1,4 @@
-"""A Python framework to build Slack apps in a flash with the latest platform features.Read the [getting started guide](https://docs.slack.dev/tools/bolt-python/creating-an-app) and look at our [code examples](https://github.com/slackapi/bolt-python/tree/main/examples) to learn how to build apps using Bolt.
+"""A Python framework to build Slack apps in a flash with the latest platform features. Read the [getting started guide](https://docs.slack.dev/tools/bolt-python/creating-an-app) and look at our [code examples](https://github.com/slackapi/bolt-python/tree/main/examples) to learn how to build apps using Bolt.
 
 * Website: https://docs.slack.dev/tools/bolt-python/
 * GitHub repository: https://github.com/slackapi/bolt-python

slack_bolt/adapter/falcon/resource.py

@@ -11,9 +11,10 @@
 
 
 class SlackAppResource:
-    """from slack_bolt import App.
+    """For use with WSGI Falcon Apps.
 
-    app = App().
+    from slack_bolt import App
+    app = App()
 
     import falcon
     api = application = falcon.API()

slack_bolt/adapter/socket_mode/async_base_handler.py

@@ -38,9 +38,8 @@ async def close_async(self):
         await self.client.close()
 
     async def start_async(self):
-        """Establishes a new connection and then starts infinite sleep.
+        """Establishes a new connection and then starts infinite sleep to prevent the termination of this process.
 
-        to prevent the termination of this process.
         If you don't want to have the sleep, use `#connect()` method instead.
         """
         await self.connect_async()

slack_bolt/adapter/socket_mode/base_handler.py

@@ -41,9 +41,8 @@ def close(self):
         self.client.close()
 
     def start(self):
-        """Establishes a new connection and then blocks the current thread.
+        """Establishes a new connection and then blocks the current thread to prevent the termination of this process.
 
-        to prevent the termination of this process.
         If you don't want to block the current thread, use `#connect()` method instead.
         """
         self.connect()

slack_bolt/app/app.py

@@ -720,8 +720,8 @@ def step(
     ):
         """Deprecated: register a new step from app listener.
 
-            Steps from apps for legacy workflows are now deprecated.
-            Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/
+        Steps from apps for legacy workflows are now deprecated.
+        Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/
 
         Registers a new step from app listener.
 

slack_bolt/app/async_app.py

@@ -745,8 +745,8 @@ def step(
     ):
         """Deprecated: register a new step from app listener.
 
-            Steps from apps for legacy workflows are now deprecated.
-            Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/
+        Steps from apps for legacy workflows are now deprecated.
+        Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/
 
         Registers a new step from app listener.
 
@@ -1225,7 +1225,7 @@ def dialog_cancellation(
         matchers: Optional[Sequence[Callable[..., Awaitable[bool]]]] = None,
         middleware: Optional[Sequence[Union[Callable, AsyncMiddleware]]] = None,
     ) -> Callable[..., Optional[Callable[..., Awaitable[Optional[BoltResponse]]]]]:
-        """Registers a new `dialog_submission` listener.
+        """Registers a new `dialog_cancellation` listener.
 
         Refer to https://docs.slack.dev/legacy/legacy-dialogs/ for details.
         """

slack_bolt/authorization/async_authorize.py

@@ -38,7 +38,7 @@ async def __call__(
 
 
 class AsyncCallableAuthorize(AsyncAuthorize):
-    """When you pass the authorize argument in AsyncApp constructor, this authorize implementation will be used."""
+    """When you pass the `authorize` argument in AsyncApp constructor, this `authorize` implementation will be used."""
 
     def __init__(self, *, logger: Logger, func: Callable[..., Awaitable[AuthorizeResult]]):
         self.logger = logger