Skip to content

Document remote-site onboarding flow#376

Merged
adamziel merged 1 commit into
trunkfrom
codex/document-remote-site-journey
May 18, 2026
Merged

Document remote-site onboarding flow#376
adamziel merged 1 commit into
trunkfrom
codex/document-remote-site-journey

Conversation

@adamziel
Copy link
Copy Markdown
Contributor

What it does

Adds a learner-facing Remote Sites guide for bringing an existing ForkPress-compatible WordPress site into a local branch over SSH. The guide covers thin syncs, branch creation, previews, plugin installation from wp-admin, and the top-100 plugin support target.

Rationale

The project docs had command reference coverage and a top-plugin support page, but a new user did not have a single path from forkpress init to a remote clone they could preview and modify. This adds that path and links it from the README, branching guide, command reference, and docs sidebar.

Implementation

  • Adds docs/remote-sites.md as the primary onboarding guide.
  • Links the guide from Core workflows in the docs sidebar.
  • Updates README.md, docs/branching.md, and docs/commands.md so users find the workflow before they need the full command reference.
  • Documents the thin-sync default, --include-uploads, --full-sync, --ssh-key, --ssh-port, --url, plugin install paths, and top-plugin support link.

Testing instructions

git diff --check
umask 0022 && npm test
umask 0022 && npm run build

Add a Remote Sites guide that walks new users from local site setup through SSH thin clone, plugin installation, and top-plugin compatibility.
@adamziel adamziel merged commit 8741e99 into trunk May 18, 2026
1 check passed
@adamziel adamziel deleted the codex/document-remote-site-journey branch May 18, 2026 20:13
@adamziel adamziel mentioned this pull request May 18, 2026
adamziel added a commit that referenced this pull request May 18, 2026
## Release `v0.1.45`

Version bump and release metadata update for `v0.1.45`.

**Changelog draft:**
* Support remote clone SSH credentials
([#373](#373))
* Track top WordPress plugin compatibility
([#374](#374))
* Add top plugin install smoke
([#375](#375))
* Document remote-site onboarding flow
([#376](#376))

**Full changelog:**
v0.1.44...release/v0.1.45

## Next steps

1. **Review** the changes in this pull request.
2. **Push** any additional edits to this branch (`release/v0.1.45`).
3. **Merge** this pull request to publish `v0.1.45`.

Merging will automatically build ForkPress binaries, create a GitHub
release, and update the Homebrew formula.

Co-authored-by: Codex <codex@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants