chore(ci): create reusable docs publishing workflow

[heitorlessa]

Issue number: #1333

Summary

Changes

Please provide a summary of what's being changed

This PR breaks the multiple ways to build and publish user guide & API docs to prevent future mistakes. It migrates all manual docs steps to use the new reusable_publish_docs.yml workflow. This will make it easier to support v1 and v2 docs too.

  release-docs:
    permissions:
      contents: write
      pages: write
    uses: ./.github/workflows/reusable_publish_docs.yml
    with:
      version: develop
      alias: stage

User experience

Please share what the user experience looks like before and after this change

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[rubenfonseca]

Makes sense, great job.