some work on adaptor doc