auto-update documented version for external projects

[laurentsenta]

Fixes #1128

• Re-use the documentation generation we used for go-ipfs with ipfs-udate and ipfs-cluster,
• Remove the concept of tags when creating PR, etc (because we're not tied to a single go-ipfs version anymore),
• Make the workflow callable.

Todo

• add version bump for ipfs-cluster and ipfs-update
• update image to use jq
• rename and re-organize the workflow for clarity
• tweak the action so it always uses the same branch
• test base case (updating missing version, etc).
• test the complex case (actual IPFS update) still works
• check the content of the latest repo-sync/pull-request

[laurentsenta]

Testing:

• first run (outdated dependencies) https://github.com/laurentsenta/ipfs-docs/runs/6757005580?check_suite_focus=true
• PR: Update documentation v0.12.2 laurentsenta/ipfs-docs#1
• second run (pr was still open) https://github.com/laurentsenta/ipfs-docs/actions/runs/2448332670
• third run (after merging the PR) https://github.com/laurentsenta/ipfs-docs/actions/runs/2448343640

Testing with old code:

• rollbacked documentation to v11 https://github.com/laurentsenta/ipfs-docs/runs/6757354163?check_suite_focus=true
  • fails because there are no file with the input version identifier (which is good, it'll prevent dead code)
• rollbacked & made sure we use the documentation settings: https://github.com/laurentsenta/ipfs-docs/actions/runs/2448473711
  • PR: Update documentation v0.12.2 laurentsenta/ipfs-docs#2

[laurentsenta]

Note: github doesn't detect the move so it looks like I created the whole file. This PR really "just" move the update version code lower and calls it thrice.

• We also push to a unique branch on file changes, instead of something like new-documentation-${NEW_TAG} because documentation updates are not only tied to go-ipfs versions anymore.

• I was thinking about extracting the version replace script to its own action, but I'm under the impression that would make the code more complex (spread it around 3 actions instead of a single script file).

[laurentsenta]

I started seeing a workspace error (https://github.com/laurentsenta/ipfs-docs/runs/6756806053?check_suite_focus=true) in my github action, had to update. I think the previous version was a typo (2.6.1, not 16)

Diff: repo-sync/pull-request@65194d8...65785d9

[filecorgi]

• Image optimization came back clean!
• Vuepress build was successful!

[lidel]

Thank you @laurentsenta ❤️

LGTM (/releases/latest skips release candidates, and only shows final releases, which is what we want).

Let's merge this (if there are any issues, we can improve in follow-up PR)

[lidel]

@johnnymatthews for now we track updates of these three, but if we ever add more projects, we can add them here with ease (as long they are on github and publish releases there)