This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

Coding Guidelines

This list is populated incrementally by the OpenERP Quality Team as part of the code review process. It contains a set of OpenERP specific good/bad practices, as well as a selection of more generic Python coding recommendations.

Both sections are a MUST READ for every OpenERP developer and contributor.

As an introductory rule, you should always keep in mind the following:

Every line you write will be written only once, but read many times by others (including yourself)

At the risk of stating the obvious, this means that while following the other guidelines, you should always use your best judgement in order to achieve the best readability. And if writing readable code requires an additional effort, it's worth it a thousand times.