Desarrolladores · Versiones y revisión
Versiones y revisión
Toda versión, la primera o la quincuagésima, pasa por los mismos pasos: comprobaciones automáticas en alrededor de un minuto, y luego una persona. Nada llega a la tienda de un comerciante sin revisar.
Números
Numeración de versiones
Las versiones son semver, y el tipo de versión decide qué puede cambiar. Un comerciante decide si acepta una actualización basándose en ese número, así que tiene que querer decir lo que dice.
| Tipo | Ejemplo | Puede cambiar |
|---|---|---|
| Parche | 1.4.2 → 1.4.3 | Arreglos. Sin ajustes nuevos que el comerciante deba rellenar, sin secciones retiradas. |
| Menor | 1.4.3 → 1.5.0 | Secciones, ajustes y tokens nuevos. Nada retirado. |
| Mayor | 1.5.0 → 2.0.0 | Puede retirar o renombrar secciones, con migraciones para cada una. |
"version": "2.0.0",
"migrations": {
"sections": { "harbour.slideshow": "harbour.hero", "harbour.ticker": "drop" },
"settings": { "headline": "heading" },
"tokens": { "brandColor": "colorAccent" }
}Una sección sin correspondencia se queda en la página del comerciante y se marca, nunca se borra, porque las palabras del comerciante viven en sus ajustes. Por eso una retirada sin migración se bloquea.
En paralelo
Construir la siguiente versión
Una tienda por tema lleva las dos: la versión en vivo, que es la demostración, y el borrador que está construyendo. Puede desarmar la 2.0.1 durante una semana en harbour.mywhizzy.com mientras los comerciantes siguen comprando, instalando y viendo la demostración de la 2.0.0 en la misma dirección.
| Cambia cuando | |
|---|---|
| Los archivos | Usted guarda, en el editor, en la CLI o en Claude. |
| El borrador en el entorno | Cada guardado lo monta. Usted y un revisor lo ven, mediante un enlace que pone un navegador sobre el borrador durante un día; nadie más. |
| La demostración en vivo en el entorno | Un revisor aprueba la versión. El borrador pasa a estar en vivo, con los diseños de página incluidos, y la imagen de la página del tema se vuelve a tomar. |
| Las tiendas de los comerciantes | Cada comerciante actualiza cuando quiere. |
El contenido de la demostración, productos, categorías y textos, es suyo y puede cambiarlo cuando quiera. Los diseños de página que monta en el entorno salen en vivo con el borrador cuando se aprueba, así que un diseño construido sobre una sección nueva nunca se publica sin la sección.
whizzy-theme reset --yes, o pídaselo a Claude (reset_theme). Todo cambio que nunca envió se tira; las versiones enviadas se quedan donde están.Automático
Las comprobaciones
Se ejecutan cuando envía, y validate_theme ejecuta las comprobaciones del paquete cuando quiera. Un bloqueo detiene el envío con motivos. Un aviso le llega a usted y al revisor.
| Comprobación | Qué verifica | En el peor caso |
|---|---|---|
valid | El tema instala. Se enumera todo lo que el validador descartaría; un tema que no instala siquiera se bloquea. | block |
css | El CSS sobrevive al saneado y al aislamiento. Las reglas descartadas y más de 100 kB avisan; más de 180 kB bloquea. | block |
version | La versión es más nueva que la última que envió o publicó. | block |
sections-removed | No ha desaparecido ningún tipo de sección, salvo que sea una versión mayor y las migraciones digan a dónde fue cada una. | block |
class-collisions | Ningún nombre de clase está estilado por dos secciones distintas. | block |
plugins | Cada plugin declarado está en el catálogo a una versión dentro de su rango. | block |
changelog | Hay un registro de cambios de al menos 10 caracteres. | block |
renders | Cada página que el tema compone responde sin error en su tienda de desarrollo. | block |
screenshots | Portada, categoría y producto se fotografían a 390, 768 y 1440 píxeles para el revisor. | warn |
performance | El HTML de la portada está por debajo de 600 kB y cada imagen tiene ancho. | warn |
Una persona
En qué se fijan los revisores
El revisor ve sus capturas junto a las de la última versión publicada, una comparación estructural de secciones, ajustes y CSS, los resultados de las comprobaciones y su registro de cambios. Luego repasa esta lista.
- Lo que afirma la ficha es cierto: cada función que nombra está en el tema.
- El tema se ve bien en móvil, tableta y escritorio, en cada página que compone.
- El contenido de la demostración está licenciado: el catálogo de muestra, o recursos cuya licencia pueda enseñar.
- No se copia el diseño, el nombre ni la marca de otra marca u otro tema.
- El texto que un comerciante reescribiría es un ajuste, no un literal.
- El registro de cambios dice qué cambió con palabras que un comerciante entiende.
- El correo de soporte funciona.
- Los avisos de las comprobaciones están explicados o arreglados.
Cuánto tarda
Tiempos de revisión
Nuestro objetivo son dos días laborables desde el envío hasta una decisión. La página del tema en su área de Desarrollador muestra dónde está su versión en la cola.
De vuelta a usted
Cuando se solicitan cambios
La mayoría de los primeros envíos llevan al menos una ronda. Es normal.
Llegan las notas
Desarrolladores › Temas, email, get_release_status
El revisor escribe qué cambiar, con la página y el ancho donde lo vio.Arreglar en su espacio de trabajo
La versión que envió no se edita; usted sigue trabajando en los archivos como siempre.Subir la versión
Normalmente el número de parche. Un número de versión solo se puede enviar una vez.Enviar otra vez
whizzy-theme submit -m "Addresses review notes"Diga en el registro de cambios qué cambió.
Puede retirar desde la página del tema una versión que siga esperando revisión. Una versión también puede rechazarse del todo, por ejemplo por trabajo copiado; las notas dicen por qué.
Ganado
Desarrolladores de confianza
Tras un historial de versiones limpias, el equipo puede marcar su cuenta como de confianza.
El parche de un desarrollador de confianza, sobre un tema ya listado, se publica automáticamente cuando todas las comprobaciones pasan sin avisos. Las versiones menores y mayores, y cualquier versión con un aviso, siguen pasando por una persona. El equipo puede retirar una publicación automática, y un problema con una puede costar el estatus de confianza.
Entrega
Cómo reciben los comerciantes las actualizaciones
Publicar una versión nunca cambia por sí sola una tienda en vivo.
- Las tiendas con una versión anterior ven un aviso de actualización en Diseño › Temas, con su registro de cambios.
- El comerciante elige cuándo actualizar. A nadie le cambia la tienda por debajo.
- Las migraciones corren cuando actualizan, así que sus secciones y ajustes siguen sus renombrados.
- Las actualizaciones son gratis para quien compró el tema. Vea las reglas de precio.