doc tweaks
reduce chances of a race condition