ci: integrate sync-docs workflow

[Copilot]

Implements workflow to sync repository documentation to the public-docs portal per sync-docs-dispatcher.md.

Changes

• .github/workflows/__main-ci.yml - Added sync-docs job that directly calls hoverkraft-tech/public-docs/.github/workflows/sync-docs-dispatcher.yml@18facec04f2945f4d66d510e8a06568497b73c54 (v0.1.0)
  • Runs after CI job completes
  • Skips on scheduled runs (consistent with release job)
  • Syncs markdown documentation files:
    • actions/**/README.md - All README files in actions directory
    • .github/workflows/*.md - Workflow documentation files
    • README.md - Root README file
  • Uses PUBLIC_DOCS_TOKEN secret with repository_dispatch permissions
  • Pinned to version 0.1.0 for stability and security
• SYNC_DOCS_IMPROVEMENTS.md - Implementation guide for future Copilot agents

Integration

The sync-docs job is now part of the main CI workflow and automatically syncs documentation to the public-docs portal on every push to main (excluding scheduled runs).

Implementation Guide

SYNC_DOCS_IMPROVEMENTS.md provides concise, actionable instructions for implementing the sync-docs workflow in other repositories, including:

• Quick-start implementation example
• Key points for proper integration (workflow type, version pinning, path configuration)
• YAML formatting best practices
• Recommendations for upstream documentation improvements

The guide is optimized for future Copilot agents to quickly understand and implement the workflow correctly.

Original prompt

Implmeent the sync documentation workflow, following these instructions: https://github.com/hoverkraft-tech/public-docs/blob/main/.github/workflows/sync-docs-dispatcher.md

At the end you will propose some documentaiton imlprovment from what was missing or needs to be improved in sync-docs-dispatcher.md for the next one who will read this doc

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[neilime]

@copilot handle feedbacks

[Copilot]

@copilot handle feedbacks

Feedback addressed. Integrated sync-docs directly into __main-ci.yml instead of creating a separate reusable workflow. (7787460)

[neilime]

@copilot handle feedbacks

[Copilot]

@copilot handle feedbacks

Feedback addressed. Updated sync-docs paths to be more specific and only sync markdown documentation files. (32d2aa7)

[neilime]

@copilot handle feedbacks, then update SYNC_DOCS_IMPROVEMENTS.md accordingly with concise, usefull instructions to be handle by copilot agent in the future

[Copilot]

@copilot handle feedbacks, then update SYNC_DOCS_IMPROVEMENTS.md accordingly with concise, usefull instructions to be handle by copilot agent in the future

Done. Updated workflow to version 0.1.0 and refactored SYNC_DOCS_IMPROVEMENTS.md to be concise and actionable for future Copilot agents. The guide now includes quick-start implementation example and key learnings. (2c93c54)