Add workflow_dispatch trigger to auto_review_documentation.yml for manual execution

[Copilot]

Summary

Enhanced the auto_review_documentation.yml workflow by adding the workflow_dispatch trigger to enable manual execution from the GitHub Actions UI. This addresses the limitation where the workflow could only be triggered automatically on pushes to the main branch.

Changes Made

1. Added workflow_dispatch trigger

Updated the workflow configuration to include both automatic and manual triggers:

on:
  push:
    branches:
      - main
  workflow_dispatch:

2. Enhanced documentation review logic

Improved the workflow to provide more comprehensive documentation review capabilities specific to this Azure AI content understanding repository:

• Lists all markdown files in the repository
• Checks the documentation structure in the docs/ directory
• Provides placeholders for additional review logic (linting, spell checking, etc.)

3. Added comprehensive documentation

Created .github/workflows/README.md with detailed instructions on:

• How to trigger the workflow manually
• Benefits of the workflow_dispatch feature
• Step-by-step guide for using the manual trigger

Benefits

Enhanced Usability:

• ✅ Manual execution from GitHub Actions UI
• ✅ Can be run on any branch, not just main
• ✅ Useful for reviewing documentation changes before merging
• ✅ Enables testing workflow changes without pushing to main

Improved Developer Experience:

• Developers can now validate documentation changes on feature branches
• Quality assurance team can perform on-demand documentation reviews
• No need to create dummy commits to trigger the workflow

Usage

To run the workflow manually:

1. Navigate to the Actions tab in the GitHub repository
2. Select Auto Review Documentation from the workflow list
3. Click Run workflow
4. Choose the desired branch
5. Click Run workflow to execute

This change maintains backward compatibility with the existing automatic trigger while adding the flexibility of manual execution as requested.

---

💡 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.