updated docs, fix deadlock, make position available