This is an open-source book of Python anti-patterns and worst practices. Check out docs/index.rst for more information.
Notice: This is still (and will always be) a work-in-progress, feel free to contribute by suggesting improvements, adding new articles, improving existing ones, or translating this into other languages.
You can find a PDF version of the book here.
If you add new articles, please use the provided templates. Depending on the pattern you are creating, use either the anti-pattern or the migration-pattern template.
To build the documentation, first install the required packages:
pip install -r requirements.txt
Then, go to the src directory and run make:
# HTML pages
make html
# PDF version
make latexpdf
For the PDF version, you will need a working LaTeX installation (e.g. texlive).
You will find the updated documentation in the docs folder afterwards. You can clean the folder by running make clean.
The book is made available under a Creative Commons Attribution-Non-Commercial-ShareAlike 4.0 license. This allows you to use and distribute it freely for your own non-commercial projects (e.g. for teaching) if you make your contributions available under the same license.
When using content from the book on your website or elsewhere, please add a visible link to our website or this Github project, so that your readers can easily find the original articles and make contributions.
Enjoy :)
