notes + document intended configuration options