piranna/AntiORM — pull request #14 by niwibe (2012-05-08 20:49:07+00:00)
Title: Docstrings

Bueno, he echado un ojo por encima, y por ahora solo queria recomendarte que vijiles el estilo de tu codigo, un codigo bonito es interesante leer.

Nada serio, usaria los docstrings con """ inciales, y """ finales siempre, ya que es una manera de separacion visual. Luego, usaria restructured text para formatear las cadenas:

* http://sphinx.pocoo.org/rest.html
* http://sphinx.pocoo.org/domains.html

Y los comentarios que empiezen por # que usas para separar secciones, para eso normalmente se usan espacios:

1 linea entre metodos de una clase. 2 lineas entre grupos de metodos de una clase.
2 lineas entre cada clase o funcion en el contexto global y cosas por estilo.

Usar muchos ## o cosas por estilo, a mi parecer y repito a mi parecer parece dibujos en codigo fuente, haces ver como si no tenias donde centrarte mejor, que en poner ## xD. Personalmente a mi me chirria bastante pero como eso es muy de gusto personal, si no estas deacuerdo, ningun problema :D

Luego veo de mirar mas afondo el codigo.