dev でプレビューし、本番にプロモートする

2つの環境とブランチの対応

ブランチ	サイト	検索エンジンにインデックスされますか
main	https://jenksguo.pages.dev	はい
dev	https://dev.jenksguo.xyz	いいえ (noindex)

各ブランチへの push ごとに CI が実行され、変更されたエントリをすべての言語に翻訳し、ビルドして、そのブランチ用のサイトへデプロイします。Admin の書き込みは既定で main になります。ステージングするには、--branch dev（CLI）または "branch": "dev"（REST/MCP）を指定します。

1. dev で変更します

jenks admin put content/corpus/projects/smart-energy-meter.md smart-energy-meter.md \
  -m "Smart energy meter: add thesis link" --branch dev

必要なだけ繰り返します。各書き込みは dev 上の1つのコミットになります。

2. デプロイを待ちます

jenks admin deploys --branch dev

dev の最新の実行が成功するまで待ちます。多くのエントリを変更した場合は翻訳に少し時間がかかります。

3. プレビューを確認します

変更したページを https://dev.jenksguo.xyz で開き、少なくとも1つの翻訳版も確認します。たとえば、https://dev.jenksguo.xyz/ja/projects/smart-energy-meter です。変更点に触れる質問を dev assistant に投げて、ボットが取り込めているか確認します。

jenks ask "What was Jenks's final-year project?" --api https://dev.jenksguo.xyz

4. プロモートします

jenks admin promote

これにより dev が main にマージされ、本番デプロイがトリガーされます。jenks admin deploys をもう一度実行して完了を見届け、https://jenksguo.pages.dev を確認します。

不具合がある場合

• プロモート前: dev で別のコミットとして修正するか、git で変更をリバートします。
• プロモート後: 修正を直接 main にコミットするか、dev で修正してもう一度プロモートします。git はすべてのバージョンを保持しますので、以前のファイルを復元することは常に可能です。
• プロモート時のマージ競合: だれかが main で同じファイルを直接変更しています。git で dev を main に追随させ、競合を解決し、再度プロモートします。