Projetos de visualização e protótipos temporários

Duas ideias relacionadas que existem para manter o trabalho experimental longe do trabalho que realmente importa.

Projetos de rascunho#

Um projeto de rascunho é um projeto normal que você pretende descartar. Use-o para testar o Coroid em um código-fonte desconhecido, validar uma mudança de política antes de aplicá-la amplamente ou explorar uma abordagem com a qual você não está comprometido.

O valor está no isolamento. Experimentos em um projeto de rascunho não poluem o histórico de tarefas, as métricas ou o contexto de um projeto no qual sua equipe depende.

Exclua-os quando terminar. Um projeto de rascunho que sobrevive seis meses tornou-se silenciosamente um projeto real, sem todo o cuidado de configuração que isso implica.

Ambientes de pré-visualização#

Uma pré-visualização é sua aplicação modificada em execução, construída a partir do branch gerado por uma tarefa.

Isso é importante porque algumas coisas não podem ser confirmadas apenas analisando um diff. Se uma página é renderizada corretamente, se um fluxo funciona de ponta a ponta, se uma alteração tem a aparência desejada — tudo isso requer a aplicação em execução.

As pré-visualizações são o que testes de navegador executam contra elas, e o que os revisores abrem quando uma captura de tela não resolve a dúvida.

Pré-visualizar a alteração de uma tarefa#

Na Factory, abra uma tarefa que esteja aguardando Revisão. Em "O que mudou", O que mudou, a janela de Preview inicia o branch da tarefa com um clique.

• Iniciando: as dependências do branch são instaladas e o aplicativo é iniciado. A primeira execução pode levar alguns minutos.
• Pronto: o aplicativo em execução aparece dentro da janela. Abrir o exibe em uma nova aba, e a janela indica quanto tempo resta para a visualização.
• Parar encerra-o mais cedo. Uma pré-visualização executada no Coroid para de automaticamente após uma hora.

Se a compilação falhar, Tentar novamente reinicia-a e Exibir log mostra o que deu errado. Uma alteração sem página da web para abrir, como uma alteração no backend ou em bibliotecas, exibe Nada para exibir no navegador em vez de um botão.

Iniciar uma pré-visualização que já está sendo iniciada ou em execução abre a mesma pré-visualização, para que dois revisores nunca iniciem duas cópias.

Onde uma pré-visualização é executada#

Você não escolhe onde uma pré-visualização é executada:

• Sandbox do Coroid: o padrão. O Coroid compila o branch da tarefa em um contêiner isolado que não recebe nenhum dos seus segredos. Não precisa de pull request nem de push, por isso também funciona para repositórios que ficam dentro do Coroid.
• Vercel: quando o projeto tem o Vercel conectado para implantação direta (configurações do projeto → Integrações → Revisar evidências), o Vercel compila o branch e o disponibiliza em um endereço de pré-visualização do Vercel. As próprias proteções de implantação do Vercel são aplicadas, então a pré-visualização abre em uma nova aba em vez de dentro da janela.

Um repositório no modo local-only nunca sai do Coroid e sempre faz a pré-visualização na sandbox do Coroid.

Um endereço de pré-visualização é longo e difícil de adivinhar, mas qualquer pessoa que o tenha pode abrir a pré-visualização enquanto ela estiver em execução. Trate-o como qualquer link para trabalho ainda não lançado.

Como as pré-visualizações chegam ao seu pull request#

O pull request do Coroid aberto para uma tarefa contém um link para sua pré-visualização: Pré-visualizar esta alteração no Coroid abre a revisão da tarefa e inicia a pré-visualização. O link requer login no Coroid; o próprio endereço da pré-visualização não é publicado no pull request.

Se você já possui implantações de pré-visualização — seja pelo aplicativo Git do seu provedor de hospedagem ou pela sua CI — o Coroid também as vincula como evidência de revisão, de modo que o link apareça ao lado da alteração em vez de ficar em um lugar onde você precise procurá-lo.

O objetivo é que a evidência de verificação e o código que ela valida cheguem juntos.

Quando usar cada um#

• Testar o Coroid ou uma abordagem que você pode descartar → projeto de rascunho
• Verificar se uma alteração específica se comporta corretamente → pré-visualização

Eles são complementares: um projeto de rascunho pode ter pré-visualizações como qualquer outro projeto.

Relacionados#

• Criar e configurar um projeto
• Evidência de revisão
• Provedores de evidência de revisão