improved docs on storePositions