improve docs
add doc about writing an adapter