Previsualizar en dev y promocionar a producción

Cómo se asignan los dos entornos a las ramas

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

Cada push a una rama ejecuta CI: traduce las entradas cambiadas a todos los idiomas, compila y despliega en el 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. Realiza 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 desees. Cada escritura es un commit en dev.

2. Espera el despliegue

jenks admin deploys --branch dev

Espera hasta que la última ejecución para dev termine con éxito. La traducción añade un poco de tiempo cuando muchas entradas han cambiado.

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 dev una pregunta que toque el cambio para comprobar que el bot lo incorporó:

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

4. Promociona

jenks admin promote

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

Si algo está mal

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