settings can now be overridden with flags
added documentation for settings