Icon for pep8.org: PEP 8, the Easy Way

pep8.org: PEP 8, the Easy Way

pep8.org is a cleaner, more readable version of PEP 8 — Python's official style guide.

Why It Exists

PEP 8 is the foundational style guide for Python code. Every Python developer reads it eventually. But the official version on python.org was dense, hard to scan, and not particularly pleasant to read. So I made a nicer version.

The idea was simple: take the same content, apply better typography and formatting, and host it at a memorable URL. No additions, no opinions layered on top — just PEP 8, presented the way it deserves to be presented.

  • Beautiful is better than ugly.
  • Explicit is better than implicit.
  • Simple is better than complex.
  • Complex is better than complicated.

The Zen of Python applies to presenting Python's own style guide, too.

Impact

pep8.org became a common reference link in code reviews, tutorials, and onboarding documentation. When you want to point a teammate at "use PEP 8 style," a clean, readable URL is better than a link to a PEP index page.

It's a small project — barely any code — but it solved a real friction point in how the Python community shares its most important conventions.

The Broader Pattern

This is a recurring theme in my work: noticing where developers experience unnecessary friction and removing it. The same instinct that produced Requests (HTTP shouldn't be hard) and The Hitchhiker's Guide to Python (best practices shouldn't be scattered) produced pep8.org. Good developer experience is about removing barriers between people and the things they're trying to do.

Visit