builder: Update documentation WRT environment replacement

@fredlf @SvenDowideit @jamtur01 @tiborvass 
I'd add a sentence explaining what's happening here.