add documentation covering environment specific confiration