[DOC] Various improvements to API dox.

`bamIOContext` is no longer required