Sviluppatori · Versioni e revisione
Versioni e revisione
Ogni versione, la prima o la cinquantesima, fa gli stessi passaggi: controlli automatici in circa un minuto, poi una persona. Niente arriva al negozio di un commerciante senza revisione.
Numeri
Numerazione delle versioni
Le versioni seguono semver, e il tipo di versione decide cosa può cambiare. Un commerciante decide se prendere un aggiornamento basandosi su quel numero, quindi deve voler dire quello che dice.
| Tipo | Esempio | Può cambiare |
|---|---|---|
| Patch | 1.4.2 → 1.4.3 | Correzioni. Nessuna nuova impostazione da compilare, nessuna sezione tolta. |
| Minore | 1.4.3 → 1.5.0 | Nuove sezioni, impostazioni e token. Niente tolto. |
| Maggiore | 1.5.0 → 2.0.0 | Può togliere o rinominare sezioni, con una migrazione per ognuna. |
"version": "2.0.0",
"migrations": {
"sections": { "harbour.slideshow": "harbour.hero", "harbour.ticker": "drop" },
"settings": { "headline": "heading" },
"tokens": { "brandColor": "colorAccent" }
}Una sezione senza corrispondenza resta sulla pagina del commerciante e viene segnalata, mai cancellata, perché le parole del commerciante stanno nelle sue impostazioni. Per questo una rimozione senza migrazione viene bloccata.
Fianco a fianco
Costruire la prossima versione
Un negozio per tema porta entrambe: la versione dal vivo, che è la demo, e la bozza che sta costruendo. Può smontare la 2.0.1 per una settimana su harbour.mywhizzy.com mentre i commercianti continuano a comprare, installare e guardare la demo della 2.0.0 allo stesso indirizzo.
| Cambia quando | |
|---|---|
| I file | Lei salva, nell'editor, nella CLI o in Claude. |
| La bozza sull'ambiente | Ogni salvataggio la mette in scena. La vedete lei e un revisore, tramite un link che porta un browser sulla bozza per un giorno; nessun altro. |
| La demo dal vivo sull'ambiente | Un revisore approva la versione. La bozza diventa quella dal vivo, impaginazioni comprese, e l'immagine sulla pagina del tema viene rifatta. |
| I negozi dei commercianti | Ogni commerciante aggiorna quando vuole. |
Il contenuto della demo, prodotti, categorie e testi, è suo e può cambiarlo quando vuole. Le impaginazioni che compone sull'ambiente vanno dal vivo insieme alla bozza quando viene approvata, così un'impaginazione costruita su una sezione nuova non viene mai pubblicata senza la sezione.
whizzy-theme reset --yes, oppure lo chieda a Claude (reset_theme). Ogni modifica mai inviata viene buttata; le versioni inviate restano dove sono.Automatico
I controlli
Girano quando invia, e validate_theme esegue i controlli del pacchetto in qualsiasi momento. Un blocco ferma l'invio indicando i motivi. Un avviso arriva a lei e al revisore.
| Controllo | Cosa verifica | Nel caso peggiore |
|---|---|---|
valid | Il tema si installa. Tutto quello che il validatore scarterebbe viene elencato; un tema che non si installa proprio viene bloccato. | block |
css | Il CSS sopravvive alla sanificazione e all'isolamento. Le regole scartate e più di 100 kB avvisano; più di 180 kB blocca. | block |
version | La versione è più recente dell'ultima che ha inviato o pubblicato. | block |
sections-removed | Nessun tipo di sezione è sparito, a meno che sia una versione maggiore e le migrazioni dicano dov'è finita ciascuna. | block |
class-collisions | Nessun nome di classe è stilizzato da due sezioni diverse. | block |
plugins | Ogni plugin dichiarato è a catalogo a una versione dentro il suo intervallo. | block |
changelog | C'è un changelog di almeno 10 caratteri. | block |
renders | Ogni pagina che il tema impagina risponde senza errori sul suo negozio di sviluppo. | block |
screenshots | Home, categoria e prodotto vengono fotografate a 390, 768 e 1440 pixel per il revisore. | warn |
performance | L'HTML della home sta sotto i 600 kB e ogni immagine ha una larghezza. | warn |
Una persona
Cosa guardano i revisori
Il revisore vede i suoi screenshot accanto a quelli dell'ultima versione pubblicata, un confronto strutturale di sezioni, impostazioni e CSS, i risultati dei controlli e il suo changelog. Poi scorre questo elenco.
- Quello che dice la scheda è vero: ogni funzione che nomina c'è davvero nel tema.
- Il tema sta bene su telefono, tablet e computer, su ogni pagina che impagina.
- Il contenuto della demo è licenziato: il catalogo di esempio, o risorse di cui può mostrare la licenza.
- Non copia il design, il nome o il marchio di un'altra marca o di un altro tema.
- Il testo che un commerciante riscriverebbe è un'impostazione, non un letterale.
- Il changelog dice cosa è cambiato con parole che un commerciante capisce.
- L'email di assistenza funziona.
- Gli avvisi dei controlli sono spiegati o risolti.
Quanto ci vuole
Tempi di revisione
Il nostro obiettivo sono due giorni lavorativi dall'invio a una decisione. La pagina del tema nella sua area Sviluppatori mostra a che punto è la sua versione in coda.
Di nuovo a lei
Quando vengono chieste delle modifiche
Quasi tutti i primi invii fanno almeno un giro. È normale.
Arrivano le note
Sviluppatori › Temi, email, get_release_status
Il revisore scrive cosa cambiare, con la pagina e la larghezza dove l'ha visto.Correggere nel suo spazio di lavoro
La versione che ha inviato non viene modificata; lei continua a lavorare sui file come sempre.Alzare la versione
Di solito il numero di patch. Un numero di versione si può inviare una volta sola.Inviare di nuovo
whizzy-theme submit -m "Addresses review notes"Dica nel changelog cosa ha cambiato.
Può ritirare dalla pagina del tema una versione ancora in attesa di revisione. Una versione può anche essere respinta del tutto, per esempio per lavoro copiato; le note dicono perché.
Guadagnato
Sviluppatori di fiducia
Dopo una storia di versioni pulite, lo staff può segnare il suo account come di fiducia.
La patch di uno sviluppatore di fiducia, su un tema già in elenco, viene pubblicata in automatico quando ogni controllo passa senza avvisi. Le versioni minori e maggiori, e qualsiasi versione con un avviso, passano comunque da una persona. Lo staff può ritirare una pubblicazione automatica, e un problema con una può costare lo stato di fiducia.
Consegna
Come i commercianti ricevono gli aggiornamenti
Pubblicare una versione non cambia mai da solo un negozio dal vivo.
- I negozi fermi a una versione precedente vedono un avviso di aggiornamento in Design › Temi, con il suo changelog.
- Il commerciante sceglie quando aggiornare. A nessuno cambia il negozio sotto i piedi.
- Le migrazioni girano quando aggiornano, così le loro sezioni e impostazioni seguono le sue rinomine.
- Gli aggiornamenti sono gratis per chi ha comprato il tema. Veda le regole sui prezzi.