doc: revisions to adapters/models.py