Separate asciidoc publish to separate workflow

[leandrumartin]

Pull Request Summary

Closes #433

A brief description/summary of your PR. What does it add, and why is it necessary? Does this new feature solve any problems or bugs? How was it tested — automated or manual software tests, physical hardware tests, or some other method or combination of testing techniques?

ASCIIDoc publishing has been separated from the workflow that builds them. So now:

• The build workflow runs on PR to main or develop, and on push to develop. This allows the build to be validated at those times.
• The new workflow to both build and publish runs only on push to main. This way, new documentation is published only when a new version of the library is publicly released.

[Copilot]

Pull request overview

This PR separates AsciiDoc publishing (GitHub Pages deployment) from AsciiDoc building/validation, aligning documentation publishing with public releases (pushes to main) while still validating AsciiDoc builds on PRs and develop pushes.

Changes:

• Adjust .github/workflows/asciidoc-build.yml triggers to run on PRs to main/develop, pushes to develop, and via workflow_call; remove the GitHub Pages deploy step.
• Add .github/workflows/asciidoc-publish.yml to run on pushes to main, call the reusable AsciiDoc build workflow, and deploy the generated docs to gh-pages.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
.github/workflows/asciidoc-build.yml	Removes deploy from the build workflow; adds pull_request + workflow_call triggers and narrows push to develop.
.github/workflows/asciidoc-publish.yml	New workflow that runs on main pushes and performs GitHub Pages deployment for AsciiDoc.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 5 comments.

Comments suppressed due to low confidence (1)

.github/workflows/publish-docs.yml:18

• publish-javadoc calls the reusable workflow javadoc-gh-pages.yml, which now declares on.workflow_call.secrets.GITHUB_TOKEN as required and uses ${{ secrets.GITHUB_TOKEN }}. This caller job is not passing that secret, so the workflow call will fail with a missing required secret. Pass GITHUB_TOKEN (or switch the called workflow to use ${{ github.token }} instead of a required secret).

  publish-javadoc:
    needs: publish-asciidoc
    uses: ./.github/workflows/javadoc-gh-pages.yml

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.