Adds back promote example workflow

[paynecrl97]

Also:

• Makes use of some new features- tagging, --nameOnly, and --waitForLock
• Adds exclusion specs for known flaky metadata types
• Changes production env's branch name to main (as it's more representative of a real repo)
• Changes 3rd party test result publishing to a more reliable action
• Updates workflow names to better reflect what they do
• Clarifies and updates documentation & comments

[DaRosenberg]

Nice one!

[DaRosenberg]

Suggested change

	- name: End with success if one of the branches does not correspond an OrgFlow environment
	- name: Ensure both branches are OrgFlow environments

(Just to keep step names roughly the same length and verbosity.)

[paynecrl97]

Yeah the name of this step is awkward because:

• it doesn't (and can't) end the job
• it's just a nicety to make it more explicit why subsequent steps are skipped
• this step is skipped if the branches are OrgFlow branches, which makes wording along the lines of 'ensure' or 'check' awkward

In the end I went with 'End with success' because it produces much clearer output in the job's log. i.e. you can see why subsequent steps are skipped, and this step is only ever executed in this case.

[paynecrl97]

eg OrgFlow branches:

and non-OrgFlow branches