added examples and tweaking adaptor docs