move adaptor writers docs around