fix adapter references and tweak docs