documenting environment methods