[IMP] openerp.api: improve documentation
Merge branch '8.0' of https://github.com/odoo/odoo into 8.0-linux64