use options instead of named named parameters on public methods