builder: Update documentation WRT environment replacement

@fredlf @SvenDowideit @jamtur01 @tiborvass 
Ah, sorry. I didn't see @jamtur01 's comments from earlier. Didn't mean to send a mixed message. I think this is good enough to ship now, I'll label it for later editing.