updated critical section docs