Programadores · Versões e revisão
Versões e revisão
Todas as versões, a primeira ou a quinquagésima, passam pelos mesmos passos: verificações automáticas em cerca de um minuto, depois uma pessoa. Nada chega à loja de um comerciante sem revisão.
Números
Numeração de versões
As versões seguem semver, e o tipo de versão decide o que pode mudar. Um comerciante decide se aceita uma atualização com base nesse número, por isso ele tem de querer dizer o que diz.
| Tipo | Exemplo | Pode mudar |
|---|---|---|
| Correção | 1.4.2 → 1.4.3 | Correções. Sem definições novas que o comerciante tenha de preencher, sem secções retiradas. |
| Menor | 1.4.3 → 1.5.0 | Secções, definições e tokens novos. Nada retirado. |
| Maior | 1.5.0 → 2.0.0 | Pode retirar ou renomear secções, com migrações para todas. |
"version": "2.0.0",
"migrations": {
"sections": { "harbour.slideshow": "harbour.hero", "harbour.ticker": "drop" },
"settings": { "headline": "heading" },
"tokens": { "brandColor": "colorAccent" }
}Uma secção sem correspondência fica na página do comerciante e é assinalada, nunca apagada, porque as palavras do comerciante vivem nas definições dela. É por isso que uma remoção sem migração é bloqueada.
Lado a lado
Construir a próxima versão
Uma loja por tema leva as duas: a versão ao vivo, que é a demonstração, e o rascunho que está a construir. Pode desmontar a 2.0.1 durante uma semana em harbour.mywhizzy.com enquanto os comerciantes continuam a comprar, a instalar e a ver a demonstração da 2.0.0 no mesmo endereço.
| Muda quando | |
|---|---|
| Os ficheiros | Você guarda, no editor, na CLI ou no Claude. |
| O rascunho no ambiente | Cada gravação encena-o. Você e um revisor veem-no, através de um link que põe um navegador no rascunho durante um dia; mais ninguém. |
| A demonstração ao vivo no ambiente | Um revisor aprova a versão. O rascunho passa a ao vivo, com os arranjos de página e tudo, e a imagem na página do tema é tirada outra vez. |
| As lojas dos comerciantes | Cada comerciante atualiza, quando quiser. |
O conteúdo da demonstração, produtos, categorias e textos, é seu para mudar a qualquer momento. Os arranjos de página que faz no ambiente vão ao vivo com o rascunho quando for aprovado, por isso um arranjo construído sobre uma secção nova nunca é publicado sem a secção.
whizzy-theme reset --yes, ou peça ao Claude (reset_theme). Todas as alterações que nunca submeteu são deitadas fora; as versões submetidas ficam onde estão.Automático
As verificações
Correm quando submete, e o validate_theme corre as verificações do pacote a qualquer momento. Um bloqueio para a submissão com motivos. Um aviso vai para si e para o revisor.
| Verificação | O que confirma | No pior caso |
|---|---|---|
valid | O tema instala. Tudo o que o validador deitaria fora é listado; um tema que não instala de todo é bloqueado. | block |
css | O CSS sobrevive à sanitização e ao isolamento. Regras deitadas fora e mais de 100 kB avisam; mais de 180 kB bloqueia. | block |
version | A versão é mais recente do que a última que submeteu ou publicou. | block |
sections-removed | Nenhum tipo de secção desapareceu, a não ser que seja uma versão maior e as migrações digam para onde foi cada uma. | block |
class-collisions | Nenhum nome de classe é estilizado por duas secções diferentes. | block |
plugins | Todos os plugins declarados estão no catálogo numa versão dentro do seu intervalo. | block |
changelog | Existe um registo de alterações com pelo menos 10 caracteres. | block |
renders | Todas as páginas que o tema desenha respondem sem erro na sua loja de desenvolvimento. | block |
screenshots | Início, categoria e produto são fotografados a 390, 768 e 1440 píxeis para o revisor. | warn |
performance | O HTML da página inicial está abaixo de 600 kB e todas as imagens têm largura. | warn |
Uma pessoa
O que os revisores olham
O revisor vê as suas capturas ao lado das da última versão publicada, uma comparação estrutural de secções, definições e CSS, os resultados das verificações e o seu registo de alterações. Depois percorre esta lista.
- O que a listagem afirma é verdade: todas as funcionalidades que nomeia estão no tema.
- O tema está bem num telemóvel, num tablet e num computador, em todas as páginas que desenha.
- O conteúdo da demonstração está licenciado: o catálogo de exemplo, ou recursos de que possa mostrar licença.
- Não há cópia do desenho, do nome ou da marca de outra marca ou de outro tema.
- Texto que um comerciante reescreveria é uma definição, não um literal.
- O registo de alterações diz o que mudou em palavras que um comerciante percebe.
- O e-mail de apoio funciona.
- Os avisos das verificações estão explicados ou corrigidos.
Quanto tempo
Tempos de revisão
O nosso objetivo são dois dias úteis da submissão até uma decisão. A página do tema na sua área de Programador mostra onde a sua versão está na fila.
De volta para si
Quando são pedidas alterações
A maioria das primeiras submissões leva pelo menos uma ronda. É normal.
Chegam as notas
Programadores › Temas, email, get_release_status
O revisor escreve o que mudar, com a página e a largura onde o viu.Corrigir no seu espaço de trabalho
A versão que submeteu não é editada; continua a trabalhar nos ficheiros como sempre.Subir a versão
Normalmente o número de correção. Um número de versão só pode ser submetido uma vez.Submeter outra vez
whizzy-theme submit -m "Addresses review notes"Diga no registo de alterações o que mudou.
Pode retirar da página do tema uma versão que ainda esteja à espera de revisão. Uma versão também pode ser recusada de vez, por exemplo por trabalho copiado; as notas dizem porquê.
Conquistado
Programadores de confiança
Depois de um historial de versões limpas, o pessoal pode marcar a sua conta como de confiança.
A versão de correção de um programador de confiança, num tema já listado, é publicada automaticamente quando todas as verificações passam sem avisos. Versões menores e maiores, e qualquer versão com um aviso, continuam a ir para uma pessoa. O pessoal pode puxar uma publicação automática de volta, e um problema numa delas pode custar o estatuto de confiança.
Entrega
Como os comerciantes recebem as atualizações
Publicar uma versão nunca muda uma loja ao vivo por si.
- As lojas numa versão mais antiga veem um aviso de atualização em Design › Temas, com o seu registo de alterações.
- O comerciante escolhe quando atualizar. A loja de ninguém muda por baixo dele.
- As migrações correm quando atualizam, para que as secções e definições deles sigam as suas renomeações.
- As atualizações são grátis para quem comprou o tema. Veja regras de preço.