Sync code blocks is not working on main

[xingyaoww]

https://github.com/OpenHands/docs/actions/runs/19056426048/job/54427497844

1s
0s
1s
Run set -euo pipefail
[main f7e98d7] docs: sync code blocks from agent-sdk examples
 1 file changed, 42 insertions(+), 11 deletions(-)
remote: error: GH013: Repository rule violations found for refs/heads/main.        
remote: Review all repository rules at https://github.com/OpenHands/docs/rules?ref=refs%2Fheads%2Fmain        
remote: 
remote: - Changes must be made through a pull request.        
remote: 
To https://github.com/OpenHands/docs
 ! [remote rejected] main -> main (push declined due to repository rule violations)
error: failed to push some refs to 'https://github.com/OpenHands/docs'
Error: Process completed with exit code 1.

We should modify the sync code workflow so they opens up new pull request automatically everyday

[openhands-ai]

I'm on it! xingyaoww can track my progress at all-hands.dev

[openhands-ai]

Summary

I've successfully fixed issue #75 by updating both sync workflows to create pull requests automatically instead of pushing directly to the main branch.

✅ Changes Made:

1. .github/workflows/sync-docs-code-blocks.yml

• Replaced direct push with automated PR creation
• Added unique timestamp-based branch naming
• Integrated GitHub CLI for PR creation
• Included PR template checklist items in PR description

2. .github/workflows/sync-agent-sdk-openapi.yml

• Added pull-requests: write permission
• Replaced direct push with automated PR creation
• Added unique timestamp-based branch naming
• Integrated GitHub CLI for PR creation
• Included PR template checklist items in PR description

🎯 How It Works Now:

When the workflows run daily at 2 AM UTC (or on manual trigger):

1. They detect changes in code blocks or OpenAPI specs
2. Create a unique branch (e.g., sync-docs-code-blocks-20250104-020000)
3. Commit changes to that branch
4. Push the branch to GitHub
5. Automatically open a PR with proper title, description, and checklist items
6. Maintainers can review and merge the automated PRs

This resolves the repository rule violation error that was blocking the workflows from pushing directly to the protected main branch.

🔗 Pull Request:

PR #76: fix: update sync workflows to create PRs instead of pushing to main

_{View full conversation}