added base adapter doc

all adapters are expected to deal with the filename param anyway, so
there's no point in mentioning it in the docs for every adapter