builder: Update documentation WRT environment replacement

@fredlf @SvenDowideit @jamtur01 @tiborvass 
Think its worth it to mention that in layman's terms (because of the reasons mentioned)?

Leave that decision up to you and the doc maintainers :)