documented environment creation functions