Snider 97aab0fcca docs: add VitePress documentation with GitHub Pages deployment

- VitePress config with canonical URLs to core.help
- Developer preview banner linking to main docs
- Documentation pages: quick-start, commands, core-folder, repos-yaml
- GitHub Actions workflow for Pages deployment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-31 20:28:07 +00:00

1.3 KiB

Raw Blame History

Troubleshooting

Common issues and solutions.

Installation Issues

"core: command not found"

The Core CLI isn't installed or not in PATH.

make install-core

Or manually:

./scripts/install-core.sh

"gh: command not found"

Install GitHub CLI:

# macOS
brew install gh

# Then authenticate
gh auth login -h github.com -p https -s workflow,repo,read:org,read:project,project

Clone failures

Check your SSH keys:

ssh -T git@github.com

If using HTTPS:

gh auth setup-git

GitHub Issues

"refusing to allow an OAuth App to create or update workflow"

Missing workflow scope:

gh auth refresh -h github.com -s workflow

"missing required scopes [read:project]"

Missing project scope:

gh auth refresh -h github.com -s read:project,project

Workspace Issues

Tests failing in wrong package

Check the active package in .core/workspace.yaml:

active: core-php  # Should match the package you're testing

Packages not found

Run setup to clone packages:

core setup

Or clone specific types:

core setup --only foundation,module

Getting Help

Run core doctor to check environment
Check GitHub issues: https://github.com/host-uk/core-devops/issues
Ask in Discord: https://discord.gg/host-uk

1.3 KiB Raw Blame History