additional updates to explain some defaults