refactor(adapter-reference): improve adapter API docs (#12673)

Co-authored-by: Matt Kane <[email protected]>
Co-authored-by: Sarah Rainsberger <[email protected]>
Co-authored-by: Florian Lefebvre <[email protected]>
Co-authored-by: Yan <[email protected]>

Author: 5 people