docs: add PO guide for editing site content - #221
Open
skelz0r wants to merge 1 commit into
Open
Conversation
Add a step-by-step guide in docs/ aimed at non-technical product owners so they can autonomously make small content changes (endpoint fiches, FAQ, wording, fixes) and open a pull request. Covers, with a verify-first pattern at each install step (and install instructions only when missing): terminal basics, the platform package manager, git identity, mandatory GPG commit signing plus secure personal key backup, GitHub Desktop for auth/clone, optional Docker site preview, agent-vm, and an optional one-paste setup of the remote Linear MCP server for both Claude and Codex. The guide is cross-platform: a common workflow with install steps forked per OS (macOS via Homebrew/Lima, Windows via winget/WSL2 + agent-vm-windows). Editing happens through the agent inside agent-vm (repo is shared, so no git/SSH/GPG config is needed in the VM). All git operations (branch, commit with manual DCO sign-off, push, pull request) go through GitHub Desktop, with the terminal kept only as an optional fallback. Includes prominent security disclaimers (no API keys, secrets or personal data) and a troubleshooting section. Signed-off-by: Delmaire Loïc <loic.delmaire@gmail.com>
skelz0r
force-pushed
the
docs/po-content-editing-guide
branch
from
June 25, 2026 14:02
d3acab7 to
befe6bd
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add a step-by-step guide in docs/ aimed at non-technical product owners so they can autonomously make small content changes (endpoint fiches, FAQ, wording, fixes) and open a pull request.
Covers, with a verify-first pattern at each install step (and install instructions only when missing): terminal basics, Homebrew, git identity with DCO sign-off, mandatory GPG commit signing plus secure key backup, GitHub auth and repo clone via gh, optional Docker site preview, agent-vm, and the remote Linear MCP server for both Claude and Codex.
Editing happens through the agent inside agent-vm (repo is shared, so no git/SSH/GPG config is needed in the VM); commit, sign and PR happen on the host, either via the terminal or GitHub Desktop. Includes prominent security disclaimers (no API keys, secrets or personal data) and a troubleshooting section.