Add github action to sync api docs to the user docs site

[tinygrasshopper]

• Currently this generates references docs, based on the tags supplied in the open api docs

[jgresty]

Oh and alerting, how will we know if this fails?

[tinygrasshopper]

I can see there were a lot of notes that were previously on Apiary that have been lost on the new V1 docs.

Yep, will add that feature as a followup PR

I'm still concerned what will happen if this script runs before a previous pull request is merged

The default behaviour of the PR action is to merge it into the previous PR