and I updated the documentation already because this new way seems easier to think about
and also make them more cross-shell test style