Python-EFL: The Zen of Python :)

CODING

@@ -8,6 +8,33 @@ Style
   This makes a visual distinction between C and py code and don't confuse the
   reader as "==" and "is" has different meaning in python.
 
+* Internal utility functions used in the bindings must start with an
+  underscore and must have the shortest name as possible.
+
+Design patterns
+===============
+ * From "The Zen of Python":
+
+    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!
+
 Tips
 ====
 

TODO

@@ -1,11 +1,13 @@
 
-BUGS:
+BUGS
+====
 
 * Evas: smart object doesn't work
 * Elm: remove tooltips.pxi
 
 
-TODO:
+TODO
+====
 
 * ecore.Poller
 * ecore.FileMonitor
@@ -26,7 +28,8 @@ TODO:
 * Bindings for Efreet (kuuko)
 
 
-STUFF LEFT OUT:
+STUFF LEFT OUT
+==============
 
 * EcoreEvas
 * EcoreImf
@@ -39,7 +42,8 @@ STUFF LEFT OUT:
 * edje decorators callbacks
 
 
-CHANGES FROM 1.7 to 1.8:
+CHANGES FROM 1.7 to 1.8
+=======================
 
 * added efl container package
 * ecore.file.Download => efl.ecore.FileDownload