simplifying defaults and initialization
documenting defaults