doc: adapters/adapter.py

A few grammatical improvements, fixed some broken references