Merge main: adopt Ruff + docstring formatting from #1566/#1567

Rebase the Markdown API reference migration onto main now that Ruff
(#1566) and docstring formatting/linting (#1567) have landed.

- Defer all docstring/formatting ownership to main: dropped this branch's
  hand-fenced docstring edits across slack_bolt/** so main's ruff-formatted
  docstrings are the single source. The generator's _reflow_indented_code
  now fences main's indented examples at generation time.
- Regenerated docs/english/reference/** from main's docstrings (234 pages);
  ruff docstring-code-format now shapes the fenced examples.
- Fenced the two column-0 examples in the Falcon adapter docstrings
  (resource.py, async_resource.py) that _reflow_indented_code cannot reach;
  these are the only remaining source changes in this PR.
- Replaced .flake8 with main's pyproject ruff config; scripts/format.sh and
  scripts/lint.sh now run ruff.

Net PR surface shrinks to the doc tooling (generator, requirements,
sidebar, redirects, CI drift job), the generated tree, and 2 fence fixes.

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

Author: lukegalbraithrussell

.flake8

@@ -1,2 +1,8 @@
 # change black settings
 0e4cd56b69e8f83166cd262f762802b7f18c3d21
+
+# apply ruff format across the codebase (#1566)
+5814077ee7ef79eaa4df6e4602260c179536a814
+
+# add docstring formatting + linting (#1567)
+5007ee3248fcea2171efa7c293ae9d4a46afa71f

.git-blame-ignore-revs

@@ -35,6 +35,9 @@ pip
 # JetBrains PyCharm settings
 .idea/
 
+# VS Code settings
+.vscode/
+
 tmp.txt
 .DS_Store
 logs/

.gitignore

@@ -16,7 +16,7 @@ Slack Bolt for Python -- a framework for building Slack apps in Python.
 
 ## Environment Setup
 
-You can verify the venv is active by checking `echo $VIRTUAL_ENV`. If tools like `black`, `flake8`, `mypy` or `pytest` are not found, ask the user to activate the venv.
+You can verify the venv is active by checking `echo $VIRTUAL_ENV`. If tools like `ruff`, `mypy` or `pytest` are not found, ask the user to activate the venv.
 
 A python virtual environment (`venv`) should be activated before running any commands.
 
@@ -65,10 +65,10 @@ Always use the project scripts instead of calling `pytest` directly:
 ### Formatting, Linting, Type Checking
 
 ```bash
-# Format -- Black, configured in pyproject.toml
+# Format -- Ruff formatter (+ lint autofix), configured in pyproject.toml
 ./scripts/format.sh --no-install
 
-# Lint -- Flake8, configured in .flake8
+# Lint -- Ruff linter, configured in pyproject.toml
 ./scripts/lint.sh --no-install
 
 # Type check -- mypy, configured in pyproject.toml
@@ -210,7 +210,7 @@ The core package has a **single required runtime dependency**: `slack_sdk` (defi
 - `test_async.txt` -- test runner deps (`pytest`, `pytest-asyncio`, includes `async_dev.txt`)
 - `test.txt` -- test deps without async (`pytest`, `pytest-cov`)
 - `test_adapter.txt` -- adapter-specific test deps (`moto`, `boddle`, `sanic-testing`)
-- `dev_tools.txt` -- dev tools (`mypy`, `flake8`, `black`)
+- `dev_tools.txt` -- dev tools (`mypy`, `ruff`)
 
 When adding a new dependency: add it to the appropriate `requirements/*.txt` file with version constraints, never to `pyproject.toml` `dependencies` (unless it's a core runtime dep, which is very rare).
 

AGENTS.md

@@ -18,6 +18,7 @@ def __init__(app: AsyncApp, path: str = '/slack/events')
 ```
 
 Setup Bolt as an ASGI web framework, this will make your application compatible with ASGI web servers.
+
 This can be used for production deployment.
 
 With the default settings, `http://localhost:3000/slack/events`
@@ -34,6 +35,7 @@ export SLACK_BOT_TOKEN=xoxb-***
 uvicorn app:api --port 3000 --log-level debug
 ```
 
+
 **Arguments**:
 
 - `app` _AsyncApp_ - Your bolt application

docs/english/reference/adapter/asgi/aiohttp/index.md

@@ -18,6 +18,7 @@ def __init__(app: AsyncApp, path: str = '/slack/events')
 ```
 
 Setup Bolt as an ASGI web framework, this will make your application compatible with ASGI web servers.
+
 This can be used for production deployment.
 
 With the default settings, `http://localhost:3000/slack/events`
@@ -34,6 +35,7 @@ export SLACK_BOT_TOKEN=xoxb-***
 uvicorn app:api --port 3000 --log-level debug
 ```
 
+
 **Arguments**:
 
 - `app` _AsyncApp_ - Your bolt application

docs/english/reference/adapter/asgi/async_handler.md

@@ -19,20 +19,20 @@ class BaseSlackRequestHandler()
 async def dispatch(request: AsgiHttpRequest) -> BoltResponse
 ```
 
-Dispatches a request to the Bolt App
+Dispatches a request to the Bolt App.
 
 #### handle\_installation
 
 ```python
 async def handle_installation(request: AsgiHttpRequest) -> BoltResponse
 ```
 
-Handles installation of the OAuthFlow
+Handles installation of the OAuthFlow.
 
 #### handle\_callback
 
 ```python
 async def handle_callback(request: AsgiHttpRequest) -> BoltResponse
 ```
 
-Handles the callback of the OAuthFlow
+Handles the callback of the OAuthFlow.

docs/english/reference/adapter/asgi/base_handler.md

@@ -16,6 +16,7 @@ def __init__(app: App, path: str = '/slack/events')
 ```
 
 Setup Bolt as an ASGI web framework, this will make your application compatible with ASGI web servers.
+
 This can be used for production deployment.
 
 With the default settings, `http://localhost:3000/slack/events`
@@ -32,6 +33,7 @@ export SLACK_BOT_TOKEN=xoxb-***
 uvicorn app:api --port 3000 --log-level debug
 ```
 
+
 **Arguments**:
 
 - `app` _App_ - Your bolt application

docs/english/reference/adapter/asgi/builtin/index.md

@@ -26,6 +26,7 @@ def __init__(app: App, path: str = '/slack/events')
 ```
 
 Setup Bolt as an ASGI web framework, this will make your application compatible with ASGI web servers.
+
 This can be used for production deployment.
 
 With the default settings, `http://localhost:3000/slack/events`
@@ -42,6 +43,7 @@ export SLACK_BOT_TOKEN=xoxb-***
 uvicorn app:api --port 3000 --log-level debug
 ```
 
+
 **Arguments**:
 
 - `app` _App_ - Your bolt application

docs/english/reference/adapter/asgi/index.md

@@ -28,6 +28,7 @@ class DjangoListenerStartHandler(ListenerStartHandler)
 ```
 
 Django sets DB connections as a thread-local variable per thread.
+
 If the thread is not managed on the Django app side, the connections won't be released by Django.
 This handler releases the connections every time a ThreadListenerRunner execution completes.
 
@@ -44,6 +45,7 @@ class DjangoListenerCompletionHandler(ListenerCompletionHandler)
 ```
 
 Django sets DB connections as a thread-local variable per thread.
+
 If the thread is not managed on the Django app side, the connections won't be released by Django.
 This handler releases the connections every time a ThreadListenerRunner execution completes.