-
Type:
Task
-
Resolution: Unresolved
-
Priority:
Major - P3
-
None
-
Affects Version/s: None
-
Component/s: Infrastructure
-
None
Context
PYTHON-6263 removes the blacken-docs pre-commit hook. Ruff can format Python code blocks in markdown files and code inside docstrings via docstring-code-format, but its edits are not equivalent to blacken-docs: it deletes bare ... doctest continuation markers, adds blank lines inside doctest examples, and normalizes quote style in rendered examples.
Definition of done
Enable markdown and docstring code formatting in pyproject, apply the one-time ruff format changes, and land with the doctest job green and the resulting example diffs reviewed.
Pitfalls
The doctest job executes docstring examples, so marker and blank-line changes can break it. Markdown formatting rewrites README, CONTRIBUTING, and CODING-STANDARDS.