doc: revisions to adapters/adapter.py