The Hitchhiker's Guide to Python
python-guide.org is an opinionated guide to Python best practices — installation, project structure, code style, testing, deployment, and everything in between. It became one of the most widely referenced Python resources in the world, and eventually an O'Reilly book.
Why I Built It
When I was learning Python, the advice was scattered across dozens of blog posts, Stack Overflow answers, and mailing list threads — much of it conflicting, some of it outdated. There was no single place that said: "Here's how to set up a Python project properly. Here's how to write clean code. Here's how to ship it."
So I wrote one.
The guide is deliberately opinionated. It doesn't present five options and leave you paralyzed. It says: "Do this. Here's why." That's what beginners need, and honestly, it's what experienced developers appreciate too. Decision fatigue is the enemy of getting things done.
What It Covers
- Getting Started — Installing Python properly on every platform.
- Development Environments — Virtual environments, package management, editor setup.
- Writing Great Code — Style, structure, conventions, and the patterns that make Python Python.
- Shipping Code — Packaging, distribution, documentation, testing, logging, deployment.
- Scenario Guides — Web applications, CLI tools, scientific computing, data analysis, networking.
The O'Reilly Book
The website grew into The Hitchhiker's Guide to Python, published by O'Reilly Media. Taking a community web resource and turning it into a professionally published book was a meaningful milestone — it validated the idea that opinionated, accessible technical writing has real value.
Philosophy
The guide embodies the same principle as everything else I build: if developers are confused, the documentation has failed, not the developer. Technical writing should meet people where they are, not where the author wishes they were.
Python's community has always valued readability and simplicity. The Hitchhiker's Guide tries to live up to that standard not just in the code it recommends, but in the prose that recommends it.
Related
- pep8.org — A cleaner presentation of Python's style guide.
- Requests — The "for humans" philosophy applied to code.
- Programming as Spiritual Practice — How writing code consciously changes everything.