Recommended vs default selectors #705
Description
The current default selectors of the broker seem to be:
- latest version on the main branch
- all versions that have been deployed
- all versions that are currently marked as released.
However, the current recommended selectors are
These are the recommended selectors that will cover the majority of workflows.
- `{ "mainBranch": true }` - the latest version from the main branch of each consumer, as specified by the consumer's `mainBranch` property.
- `{ "branch": "<branch>" }` - the latest version from a particular branch of each consumer.
- `{ "deployedOrReleased": true }` - all the currently deployed and currently released and supported versions of each consumer.
- `{ "matchingBranch": true }` - the latest version from any branch of the consumer that has the same name as the current branch of the provider. Used for coordinated development between consumer and provider teams using matching feature branch names.
The lack of branch in the default makes sense (needs the branch to be supplied) but matchingBranch seems like it could be inferred if the provider specifies it.
It would make sense for the recommended selectors to be the default, so most users can point at the broker and have a functional workflow without additional work. This would also simplify the docs.