Développeurs · Versions et revue
Versions et revue
Chaque version, la première comme la cinquantième, passe par les mêmes étapes : des vérifications automatiques en une minute environ, puis une personne. Rien n'atteint la boutique d'un marchand sans revue.
Numéros
Numérotation des versions
Les versions suivent semver, et le type de version décide de ce qu'elle a le droit de changer. Un marchand décide de prendre une mise à jour à partir de ce numéro : il faut donc qu'il veuille dire ce qu'il dit.
| Type | Exemple | Peut changer |
|---|---|---|
| Correctif | 1.4.2 → 1.4.3 | Des corrections. Aucun nouveau réglage à remplir, aucune section retirée. |
| Mineure | 1.4.3 → 1.5.0 | De nouvelles sections, de nouveaux réglages et jetons. Rien de retiré. |
| Majeure | 1.5.0 → 2.0.0 | Peut retirer ou renommer des sections, avec une migration pour chacune. |
"version": "2.0.0",
"migrations": {
"sections": { "harbour.slideshow": "harbour.hero", "harbour.ticker": "drop" },
"settings": { "headline": "heading" },
"tokens": { "brandColor": "colorAccent" }
}Une section sans correspondance reste sur la page du marchand et est signalée, jamais supprimée, parce que les mots du marchand vivent dans ses réglages. C'est pourquoi un retrait sans migration est bloqué.
Côte à côte
Construire la version suivante
Une boutique par thème porte les deux : la version en direct, qui est la démo, et le brouillon que vous construisez. Vous pouvez démonter la 2.0.1 pendant une semaine sur harbour.mywhizzy.com pendant que les marchands continuent d'acheter, d'installer et de regarder la démo de la 2.0.0 à la même adresse.
| Change quand | |
|---|---|
| Les fichiers | Vous enregistrez, dans l'éditeur, la CLI ou Claude. |
| Le brouillon sur l'environnement | Chaque enregistrement le monte. Vous et un relecteur le voyez, par un lien qui place un navigateur sur le brouillon pendant un jour ; personne d'autre. |
| La démo en direct sur l'environnement | Un relecteur approuve la version. Le brouillon devient la version en direct, mises en page comprises, et l'image de la page du thème est reprise. |
| Les boutiques des marchands | Chaque marchand met à jour quand il le décide. |
Le contenu de la démo, produits, catégories et textes, est à vous, modifiable à tout moment. Les mises en page que vous composez sur l'environnement passent en direct avec le brouillon lorsqu'il est approuvé, si bien qu'une mise en page bâtie sur une nouvelle section n'est jamais publiée sans la section.
whizzy-theme reset --yes, ou demandez-le à Claude (reset_theme). Chaque modification jamais soumise est jetée ; les versions soumises restent où elles sont.Automatique
Les vérifications
Elles tournent quand vous soumettez, et validate_theme lance les vérifications du paquet à tout moment. Un blocage arrête la soumission en donnant les raisons. Un avertissement vous parvient à vous et au relecteur.
| Vérification | Ce qu'elle vérifie | Au pire |
|---|---|---|
valid | Le thème s'installe. Tout ce que le validateur écarterait est listé ; un thème qui ne s'installe pas du tout est bloqué. | block |
css | Le CSS survit au nettoyage et au cloisonnement. Les règles écartées et plus de 100 ko avertissent ; plus de 180 ko bloque. | block |
version | La version est plus récente que la dernière que vous avez soumise ou publiée. | block |
sections-removed | Aucun type de section n'a disparu, sauf s'il s'agit d'une version majeure et que les migrations disent où chacun est parti. | block |
class-collisions | Aucun nom de classe n'est stylé par deux sections différentes. | block |
plugins | Chaque plugin déclaré est au catalogue à une version comprise dans votre intervalle. | block |
changelog | Il y a un journal des changements d'au moins 10 caractères. | block |
renders | Chaque page que le thème met en page répond sans erreur sur votre boutique de développement. | block |
screenshots | L'accueil, la catégorie et le produit sont photographiés à 390, 768 et 1440 pixels pour le relecteur. | warn |
performance | Le HTML de la page d'accueil fait moins de 600 ko et chaque image a une largeur. | warn |
Une personne
Ce que regardent les relecteurs
Le relecteur voit vos captures à côté de celles de la dernière version publiée, une comparaison structurelle des sections, des réglages et du CSS, les résultats des vérifications et votre journal des changements. Puis il parcourt cette liste.
- Ce qu'annonce la fiche est vrai : chaque fonction qu'elle nomme est bien dans le thème.
- Le thème rend bien sur téléphone, tablette et ordinateur, sur chaque page qu'il met en page.
- Le contenu de la démo est sous licence : le catalogue d'exemple, ou des ressources dont vous pouvez montrer la licence.
- Aucune copie du design, du nom ou de la marque d'une autre marque ou d'un autre thème.
- Un texte qu'un marchand réécrirait est un réglage, pas une valeur en dur.
- Le journal des changements dit ce qui a changé avec des mots qu'un marchand comprend.
- L'adresse d'assistance fonctionne.
- Les avertissements des vérifications sont expliqués ou corrigés.
Combien de temps
Délais de revue
Notre objectif est de deux jours ouvrés entre la soumission et une décision. La page du thème dans votre espace Développeur montre où en est votre version dans la file.
Ça vous revient
Quand des changements sont demandés
La plupart des premières soumissions font au moins un aller-retour. C'est normal.
Les remarques arrivent
Développeurs › Thèmes, email, get_release_status
Le relecteur écrit ce qu'il faut changer, avec la page et la largeur où il l'a vu.Corriger dans votre espace de travail
La version que vous avez soumise n'est pas modifiée ; vous continuez à travailler sur les fichiers comme d'habitude.Monter la version
En général le numéro de correctif. Un numéro de version ne peut être soumis qu'une fois.Soumettre à nouveau
whizzy-theme submit -m "Addresses review notes"Dites dans le journal des changements ce que vous avez changé.
Vous pouvez retirer depuis la page du thème une version qui attend encore la revue. Une version peut aussi être refusée d'emblée, par exemple pour du travail copié ; les remarques disent pourquoi.
Mérité
Développeurs de confiance
Après un historique de versions propres, l'équipe peut marquer votre compte comme de confiance.
Le correctif d'un développeur de confiance, sur un thème déjà listé, est publié automatiquement quand toutes les vérifications passent sans avertissement. Les versions mineures et majeures, et toute version avec un avertissement, passent toujours par une personne. L'équipe peut retirer une publication automatique, et un problème sur l'une d'elles peut coûter le statut de confiance.
Livraison
Comment les marchands reçoivent les mises à jour
Publier une version ne change jamais à elle seule une boutique en service.
- Les boutiques restées sur une version antérieure voient un avis de mise à jour dans Design › Thèmes, avec votre journal des changements.
- Le marchand choisit quand mettre à jour. La boutique de personne ne change sous ses pieds.
- Les migrations tournent au moment de leur mise à jour, pour que leurs sections et réglages suivent vos renommages.
- Les mises à jour sont gratuites pour qui a acheté le thème. Voir les règles de prix.