Markdown editorial handoff
A writer gives an editor a complete draft. The editor preserves the original, writes a reviewed copy, and checks the actual diff before a site maintainer renders it locally.
This is a local HTML artifact, not a GitHub page. It has no login, upload, save, pull request, merge, or publish action.
draft-v1.md · writer handoff
The maintenance guide says that a release check should happen before publishing.
## Draft instruction
Run the validation command before publishing.
Revision: draft-v1
reviewed-v2.md · editor revision
The maintenance guide says that a release check should happen before publishing.
## Reviewed instruction
From the project root, run the validation command documented for this site. Record the result or the failing step in the handoff note, then give the editor this revised Markdown instead of changing a copied webpage.
Revision: reviewed-v2
draft-to-reviewed.diff · what changed
--- draft-v1.md +++ reviewed-v2.md @@ -2,8 +2,8 @@ The maintenance guide says that a release check should happen before publishing. -## Draft instruction +## Reviewed instruction -Run the validation command before publishing. +From the project root, run the validation command documented for this site. Record the result or the failing step in the handoff note, then give the editor this revised Markdown instead of changing a copied webpage. -Revision: draft-v1 +Revision: reviewed-v2
Handoff checks
- Writer: hand over the full Markdown file and keep the revision marker.
- Reviewer: preserve the original, read the unified diff, and return unclear facts as questions.
- Maintainer: render the reviewed file locally and record an accept-or-return decision.