docs update (heterogenous environments)