Previsualizar en dev y promover a producción

Cómo se asignan los dos entornos a las ramas

Rama	Sitio	Indexado por motores de búsqueda
main	https://jenksguo.pages.dev	sí
dev	https://dev.jenksguo.xyz	no (noindex)

Cada push a una rama ejecuta CI: traduce las entradas cambiadas a todos los idiomas, construye y despliega al sitio de esa rama. Las escrituras de Admin van a main por defecto; pasa --branch dev (CLI) o "branch": "dev" (REST/MCP) para preparar en su lugar.

1. Haz cambios en dev

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

Repite para tantos cambios como quieras. Cada escritura es un commit en dev.

2. Espera el despliegue

jenks admin deploys --branch dev

Espera hasta que la última ejecución de dev finalice correctamente. La traducción añade algo de tiempo cuando se han cambiado muchas entradas.

3. Revisa la vista previa

Abre las páginas cambiadas en https://dev.jenksguo.xyz y al menos una versión traducida, por ejemplo https://dev.jenksguo.xyz/ja/projects/smart-energy-meter. Hazle al asistente de desarrollo una pregunta que toque el cambio para comprobar que el bot lo haya recogido:

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

4. Promueve

jenks admin promote

Esto fusiona dev en main y desencadena el despliegue de producción. Ejecuta jenks admin deploys de nuevo para verlo finalizar y luego comprueba https://jenksguo.pages.dev.

Si algo no está bien

• Antes de promover: arréglalo en dev con otro commit, o revierte el cambio en git.
• Después de promover: haz commit del arreglo directamente en main, o arréglalo en dev y vuelve a promover. Git conserva todas las versiones, así que siempre es posible restaurar un archivo anterior.
• Conflicto de fusión al promover: alguien cambió directamente el mismo archivo en main. Pon dev al día con main en git, resuélvelo y vuelve a promover.