Improve documentation for barrier insertion rework