chore: enable ruff pydocstyle (D) rules for docstring lint + formatting

Enable Ruff's pydocstyle `D` rules with the google convention and
`docstring-code-format`, and fix every resulting violation on docstrings
that already exist across slack_bolt/ and examples/.

- pyproject.toml: select "D" (google convention); ignore only the
  missing-docstring rules D100-D107 so no docstrings are invented where
  none exist; enable docstring-code-format.
- Fix all D2xx/D4xx violations on existing docstrings (D205 blank line
  after summary, D415 terminal punctuation, D417 undocumented params, and
  safe structural fixes). No docstrings added.
- scripts/format.sh: format examples/ too.
- scripts/lint.sh: add `ruff format --check` gate so local matches CI.

Sync/async docstring pairs updated symmetrically.

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

Author: WilliamBergamin

examples/django/manage.py

@@ -1,5 +1,6 @@
 #!/usr/bin/env python
 """Django's command-line utility for administrative tasks."""
+
 import os
 import sys
 

examples/django/myslackapp/asgi.py

@@ -1,5 +1,4 @@
-"""
-ASGI config for myslackapp project.
+"""ASGI config for myslackapp project.
 
 It exposes the ASGI callable as a module-level variable named ``application``.
 

examples/django/myslackapp/settings.py

@@ -1,5 +1,4 @@
-"""
-Django settings for myslackapp project.
+"""Django settings for myslackapp project.
 
 Generated by 'django-admin startproject' using Django 3.2.3.
 
@@ -9,6 +8,7 @@
 For the full list of settings and their values, see
 https://docs.djangoproject.com/en/3.2/ref/settings/
 """
+
 import os
 from pathlib import Path
 

examples/django/myslackapp/urls.py

@@ -1,7 +1,8 @@
-"""myslackapp URL Configuration
+"""myslackapp URL Configuration.
 
 The `urlpatterns` list routes URLs to views. For more information please see:
     https://docs.djangoproject.com/en/3.2/topics/http/urls/
+
 Examples:
 Function views
     1. Add an import:  from my_app import views
@@ -13,6 +14,7 @@
     1. Import the include() function: from django.urls import include, path
     2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
 """
+
 from django.contrib import admin  # noqa: F401
 from django.urls import path
 

examples/django/myslackapp/wsgi.py

@@ -1,5 +1,4 @@
-"""
-WSGI config for myslackapp project.
+"""WSGI config for myslackapp project.
 
 It exposes the WSGI callable as a module-level variable named ``application``.
 

examples/django/oauth_app/migrations/0001_initial.py

@@ -4,7 +4,6 @@
 
 
 class Migration(migrations.Migration):
-
     initial = True
 
     dependencies = []

examples/django/oauth_app/migrations/0002_token_rotation.py

@@ -5,7 +5,6 @@
 
 
 class Migration(migrations.Migration):
-
     dependencies = [
         ("oauth_app", "0001_initial"),
     ]

examples/google_cloud_functions/oauth_main.py

@@ -52,6 +52,7 @@ def event_test(body, say, logger):
 # Cloud Function
 def hello_bolt_app(req: Request):
     """HTTP Cloud Function.
+
     Args:
         req (flask.Request): The request object.
         <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>

examples/google_cloud_functions/simple_main.py

@@ -32,6 +32,7 @@ def event_test(body, say, logger):
 # Cloud Function
 def hello_bolt_app(req: Request):
     """HTTP Cloud Function.
+
     Args:
         req (flask.Request): The request object.
         <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>

examples/message_events.py

@@ -46,8 +46,7 @@ def reply_in_thread(body: dict, say: Say):
     event={"type": "message", "subtype": "message_deleted"},
     matchers=[
         # Skip the deletion of messages by this listener
-        lambda body: "You've deleted a message: "
-        not in body["event"]["previous_message"]["text"]
+        lambda body: "You've deleted a message: " not in body["event"]["previous_message"]["text"]
     ],
 )
 def detect_deletion(say: Say, body: dict):