Skip to content
Draft
Changes from 19 commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
93d67eb
Add CI automation for automatic Beman docs import
Dec 9, 2025
fc5c628
Tweaks
Dec 9, 2025
e428d0f
Tweaks
Dec 9, 2025
4310530
Tweaks
Dec 9, 2025
2d55b53
Tweaks
Dec 9, 2025
9f8201a
Test: Add PR testing support to sync-docs workflow
Jan 19, 2026
a9c4250
Add test mode for PR creation in sync-docs workflow
Jan 19, 2026
05d5b68
Use unique branch name format: website-weekly-docs-import-yyyy-mm-dd
Jan 19, 2026
3c0411a
Fix: Clean up beman directory and handle PR permission limitations
Jan 19, 2026
8b2cff9
Add workflow_dispatch input for test mode
Jan 19, 2026
ac9553a
Add debug info and repository settings check for workflow_dispatch
Jan 19, 2026
eacee61
Add support for Personal Access Token (PAT) to fix permission issues
Jan 19, 2026
9f02335
Improve PAT detection and instructions
Jan 19, 2026
b687a4f
Add better PAT detection and error messages
Jan 19, 2026
be37714
Clean up workflow: remove test/debug code, keep only production funct…
Jan 19, 2026
4d8fd67
Add back Show changes step with git status and git diff
Jan 19, 2026
11bccda
Add back pull_request trigger so workflow runs on PRs
Jan 19, 2026
50e26b5
Allow PR creation on PRs when PAT is available
Jan 19, 2026
54f5d12
Add repository_dispatch trigger for on-demand API triggering
Jan 19, 2026
bc70e5e
Update .github/workflows/sync-docs.yml
neatudarius Jan 19, 2026
cfc912d
Update .github/workflows/sync-docs.yml
neatudarius Jan 19, 2026
f075c11
Update .github/workflows/sync-docs.yml
neatudarius Jan 19, 2026
9889e4f
Add SPDX identifier
Jan 19, 2026
4a29520
Fail fatal if PAT is missing when running on PRs
Jan 19, 2026
b393851
Add comprehensive debug section before Create Pull Request step
Jan 19, 2026
ee01cd9
Trigger workflow run
Jan 19, 2026
9721372
Move debug section earlier in workflow (after branch name generation)
Jan 19, 2026
c019525
Move Show changes step right after Generate branch name
Jan 19, 2026
03acade
Trigger workflow run to test GH_PAT
Jan 19, 2026
48033e2
Re-test workflow with GH_PAT secret
Jan 19, 2026
adbaa04
Trigger workflow run again
Jan 19, 2026
9bb9c56
Trigger workflow run
Jan 19, 2026
ee0dc4c
Update PR title to include date and review request
Jan 19, 2026
72d7bf2
Update PR: set assignee to neatudarius, add reviewers, and link to is…
Jan 19, 2026
1544255
Fix issue reference text: 'automatic docs import'
Jan 19, 2026
906bee9
Change 'Evergreen' to 'evergreen' (lowercase)
Jan 19, 2026
ed9c751
Simplify workflow: keep only schedule trigger, remove manual triggers…
Jan 19, 2026
692aef4
Add comprehensive documentation explaining workflow purpose, schedule…
Jan 19, 2026
e8494e6
Optimize checkout: change fetch-depth from 0 to 1 for better performance
Jan 19, 2026
5fd264f
Remove unnecessary cleanup step - GitHub Actions runners auto-cleanup…
Jan 19, 2026
29d3785
Make error message more generic: clarify repository Settings location
Jan 19, 2026
7adddaa
Make assignees and reviewers configurable via repository variables wi…
Jan 19, 2026
5d59528
Add workflow_dispatch and repository_dispatch triggers for manual tes…
Jan 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 94 additions & 0 deletions .github/workflows/sync-docs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
name: Auto-sync Beman Docs

on:
push:
branches:
- main
pull_request:
workflow_call:
workflow_dispatch:
repository_dispatch:
types:
- sync-docs
schedule:
- cron: '0 6 * * MON' # 09:00 Romania time

permissions:
contents: write
pull-requests: write

jobs:
sync:
runs-on: ubuntu-latest

steps:
- name: Checkout website repo
uses: actions/checkout@v4
with:
fetch-depth: 0

- name: Checkout beman repo
uses: actions/checkout@v4
with:
repository: bemanproject/beman
path: beman

- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.x'

- name: Run sync-docs.py
run: |
python3 scripts/sync-docs.py beman

- name: Clean up beman directory
run: |
rm -rf beman

- name: Generate branch name
id: branch-name
run: |
BRANCH_NAME="website-weekly-docs-import-$(date +%Y-%m-%d)"
echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT
echo "Generated branch name: $BRANCH_NAME"

- name: Show changes
run: |
echo "=== Changes detected ==="
git status
echo ""
echo "=== Diff ==="
git diff || echo "No changes detected"

- name: Check if PAT is available
id: check-pat
run: |
if [ -n "${{ secrets.GH_PAT }}" ]; then
echo "pat_available=true" >> $GITHUB_OUTPUT
echo "✅ GH_PAT secret is available - will use it for PR creation"
else
echo "pat_available=false" >> $GITHUB_OUTPUT
echo "⚠️ GH_PAT secret not found - using GITHUB_TOKEN (limited permissions on PRs)"
fi

- name: Create Pull Request
if: github.event_name != 'pull_request' || steps.check-pat.outputs.pat_available == 'true'
uses: peter-evans/create-pull-request@v6
with:
token: ${{ secrets.GH_PAT || secrets.GITHUB_TOKEN }}
base: main
commit-message: "Auto-sync documentation from latest content of bemanproject/beman"
branch: ${{ steps.branch-name.outputs.branch_name }}
title: "Weekly docs sync"
body: |
Automated sync of documentation and images from latest content of bemanproject/beman.
Triggered by the weekly schedule.
labels: |
sync
automation
author: "github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
assignees: |
neatudarius
RaduNichita
mguludag
Loading