From 32f664aa3dc9039dac78861e013f3c1403282a2d Mon Sep 17 00:00:00 2001 From: John Del Rosario Date: Sat, 31 Dec 2011 00:46:52 +0800 Subject: [PATCH] Add full Zen of Python in Code Style section. --- docs/writing/style.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/writing/style.rst b/docs/writing/style.rst index 216c780..803dca1 100644 --- a/docs/writing/style.rst +++ b/docs/writing/style.rst @@ -16,6 +16,27 @@ Also known as PEP 20, the guiding principles for Python's design. :: >>> import this + The Zen of Python, by Tim Peters + + Beautiful is better than ugly. + Explicit is better than implicit. + Simple is better than complex. + Complex is better than complicated. + Flat is better than nested. + Sparse is better than dense. + Readability counts. + Special cases aren't special enough to break the rules. + Although practicality beats purity. + Errors should never pass silently. + Unless explicitly silenced. + In the face of ambiguity, refuse the temptation to guess. + There should be one-- and preferably only one --obvious way to do it. + Although that way may not be obvious at first unless you're Dutch. + Now is better than never. + Although never is often better than *right* now. + If the implementation is hard to explain, it's a bad idea. + If the implementation is easy to explain, it may be a good idea. + Namespaces are one honking great idea -- let's do more of those! See ``_ for some examples.