fix a couple docs, found a race condition