Рекомендации по документированию

Полезная и полная документация

Кажлый метод объекта ORM принимает один и тот же параметр self, cr, uid и чаще всего список ids и дополнительно context, так что было бы чересчур копировать/вставлять описание очевидных параметров каждый раз:

def action_send(self, cr, uid, ids, context=None):
    """ This sends an email to ALL the addresses of the selected partners.
    @param self: The object pointer
    @param cr: the current row, from the database cursor,
    @param uid: the current user ID for security checks
    @param ids: List of Phonecall to Opportunity's IDs
    @param context: A standard dictionary for contextual values
    """

def action_send(self, cr, uid, ids, context=None):
    """ This sends an email to ALL the addresses of the selected partners.
    @param context['mail']: 'new' to send a new mail or 'reply' if to reply to the last case_history
    """