doc: adapters

Small revisions, added some references I though were important