[WIP] start updating docs to explain managing environment and services