maybe we should push this one up? it seems you started documenting options alphabetically, but now they are mixed... maybe we should start with required ones, then follow with the optionals.