Skip to content

docs: clarify relationship between Black style and PEP 8#5025

Merged
cobaltt7 merged 1 commit intopsf:mainfrom
mitre88:codex/issue-1272-pep8-subset-wording
Mar 8, 2026
Merged

docs: clarify relationship between Black style and PEP 8#5025
cobaltt7 merged 1 commit intopsf:mainfrom
mitre88:codex/issue-1272-pep8-subset-wording

Conversation

@mitre88
Copy link
Contributor

@mitre88 mitre88 commented Mar 5, 2026

Description

This updates the sentence in current_style.md that currently says Black's style is a "strict subset of PEP 8".

The new wording makes the intent explicit:

  • Black follows PEP 8 in spirit
  • it enforces a consistent subset of PEP 8 formatting recommendations
  • it does not implement every style rule covered by PEP 8

This addresses ambiguity reported in #1272.

Fixes #1272

Checklist

  • Add new / update outdated documentation?

@cobaltt7 cobaltt7 added the ci: skip news Pull requests that don't need a changelog entry. label Mar 5, 2026
@cobaltt7 cobaltt7 merged commit 7e5a828 into psf:main Mar 8, 2026
12 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci: skip news Pull requests that don't need a changelog entry.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README Ambiguous: "strict subset of PEP 8"

2 participants