Skip to main content

Git Workflow

Repository Structure​

brain-donnyaw-cf-pages/
├── opshell/                    # Opshell guide documentation
├── ...topic directories...     # Other doc sets (php, cloudflare, etc.)
├── docusaurus.config.opshell.js
├── sidebars.opshell.js
└── package.json

Branch Strategy​

BranchPurpose
mainProduction-ready code
developIntegration branch
feature/*New features and changes
fix/*Bug fixes
docs/*Documentation updates

Workflow​

# Start new feature
git checkout -b feature/new-plugin-docs
# Make changes, commit
git add opshell/08-plugins/
git commit -m "docs(opshell): add new plugin documentation"
# Push and create PR
git push origin feature/new-plugin-docs
# After review, merge to main
git checkout main
git merge feature/new-plugin-docs
git push origin main

Commit Conventions​

type(scope): description

Types: docs, feat, fix, refactor, chore
Scope: opshell, server, contact-form, plugins

Examples:

  • docs(opshell): add server infrastructure section
  • feat(contact-form): add Turnstile verification
  • fix(server): update OpenLiteSpeed config

Deployment via Git​

# On server
cd /home/wp_opshell_dev/sites/opshell.dev
git pull origin main
# Verify changes
git log --oneline -5

Theme & Plugin Versioning​

  • Theme versions tracked via style.css header
  • Plugin versions tracked via plugin header
  • Docusaurus docs deployed via Git push to Cloudflare Pages (automated)