Update docs for branches and environments

[bethesque]

List of specific locations for update from Rafael on Slack

• Does “latest” pacts apply to branches too? Assuming you only have branches and no tags, will it work? This isn’t clear and isn’t reflected in the branches documentation https://docs.pact.io/pact_broker/tags#latest-pacts and https://docs.pact.io/pact_broker/tags#when-retrieving-pacts-to-verify
• There is no way to identify versions by environment using the new record-deployment approach https://docs.pact.io/pact_broker/tags#identifying-versions-by-tag and https://pact.canny.io/feature-requests/p/support-environmentreleases-on-describe-version
• This mention of environments and can-i-deploy is outdated in the context of the new record-deployment /record-releases https://docs.pact.io/pact_broker/tags#before-deploying-to-an-environment
• This section is outdated: https://docs.pact.io/pact_broker/branches#support (I think this is a known problem and a hard one to circumvent, so it’s ok)
• The recommended configuration for providers is outdated https://docs.pact.io/provider/recommended_configuration#verification-triggered-by-provider-change
• The recommended configuration for consumers is outdated https://docs.pact.io/consumer/recommended_configuration
• Overall, my proposal involves mostly migrating all the information we have on https://docs.pact.io/pact_broker/tags to https://docs.pact.io/pact_broker/branches, and updating it where applicable.

https://pact-foundation.slack.com/archives/CAN147DFD/p1648472813437489

[YOU54F]

cc @rafael-anachoreta

[bethesque]

Also https://github.com/pact-foundation/docs.pact.io/blob/master/website/docs/pact_broker/advanced_topics/consumer_version_selectors.md

These should be using the { mainBranch: true }, { deployedOrReleased: true } selectors.

[bethesque]

https://docs.pact.io/pact_nirvana/step_5#d-configure-pact-to-be-verified-when-provider-changes

We shouldn't ever let document how to publish without branch/tags. This shouldn't need to be a step. We start with branches from the beginning now.