Documentação

A oficina

O que a fábrica entregou, quanto custou, o que precisa de você e como cada etapa do trabalho foi executada.

A fábrica é onde você chega após fazer login. Ela exibe o que sua fábrica entregou e quanto custou, além do que precisa de você; cada tarefa e plano são apresentados como a história de como o trabalho foi feito. Tarefas, faixas, planos, automações e relatórios estão todos acessíveis a partir dela, para que você tenha um único lugar para responder: "O que obtivemos e o que precisa de mim?"

Para que serve?

A fábrica responde: "O que foi entregue, quanto custou e o que precisa de mim?". O Mission Control, a apenas um clique de distância, responde: "O que está em execução agora?"

A diferença é importante quando você tem mais de algumas tarefas em andamento. A fábrica é onde você decide; o Mission Control é onde você acompanha.

Visão geral

Escolha esta semana ou este mês, e todos os projetos ou um deles, sob o título.

  • Três indicadores: pull requests mesclados, trabalho concluído e dinheiro gasto, cada um comparado com o período anterior ("4 a mais que na semana passada"). O número de mesclagens contabiliza cada pull request mesclado nos seus repositórios conectados, independentemente de quem o abriu, e informa quantos foram feitos pelo Coroid ("11 pelo Coroid"). Escolha um indicador para vê-lo nas últimas oito semanas ou meses; o custo por pull request mesclado pelo Coroid aparece abaixo do gráfico. Os indicadores vêm de registros, nunca de um modelo.
  • Precisa de você Lista apenas decisões que alguém precisa tomar: um plano para aprovar, trabalho para revisar ou mesclar, um problema de teste sem tarefa associada, uma solicitação para aceitar e trabalho que falhou ou está bloqueado. Seu título conta quantos existem; os cinco primeiros são exibidos, Mostrar mais Adiciona o restante. Abra uma linha para ver sua única ação, ou deixe-a de lado com "Agora não".
  • Projetos Exibe uma linha por projeto com trabalho no período, sendo os mais mesclados exibidos primeiro. Abra uma linha para ver os indicadores próprios do projeto, seu trabalho em andamento, se o que foi entregue está funcionando bem em produção e como o trabalho foi executado: com que frequência a QA aprovou na primeira tentativa e quanto tempo leva do pedido à entrega. Projetos sem nada no período são agrupados em uma linha ("4 projetos estão inativos").
  • Concluído esta semana Lista os resultados, do mais recente para o mais antigo; as automações rotineiras são agrupadas em uma única linha.
  • Todo o trabalho Abre a lista completa de tarefas, faixas, planos, automações e relatórios, por status.

Quando o trabalho é mesclado, use Lançamentos para acompanhar o commit selecionado desde a preparação, tentativas de implantação até a saúde do ambiente. Uma tarefa concluída ou uma faixa promovida não são resultados de implantação.

Fábrica
Esta semanacoroid-expoMinhas solicitaçõesResumo da Fábrica
Mesclados
9
6 more than last week
7 pelo Coroid
Concluídos
7
5 more than last week
Gastos
US$ 17,41
376% more than last week
14 de set.Esta semana
Requer sua atenção10
Selecionar
  • Upgrade uuid (breaking change) is blockedcoroid-expo · há 2 dias
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · há 4 dias
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · há 4 dias
Projetos
  • coroid-expo9 mesclados · 7 concluídos · US$ 17,41 · 10 aguardando sua intervenção

Visão geral da Fábrica: os dados da semana em três valores numéricos e um gráfico, o que requer sua atenção e uma linha por projeto. Dados ilustrativos.

Resolver muitas decisões de uma vez

Quando o trabalho antigo se acumula em "Precisa de você", selecione várias linhas: passe o mouse sobre uma linha e seu ponto se transformará em uma caixa de seleção, ou use Selecionar ao lado do título (em celulares). Selecionar todas seleciona todas as linhas. Depois:

  • Agora não Deixa as linhas de lado para você até que seu trabalho mude. Outras pessoas ainda as veem.
  • Fechar para todos (proprietários e administradores) arquiva os planos, cancela as tarefas aguardando revisão e descarta o restante (trabalho falho, problemas de teste, solicitações) para toda a organização até que seu trabalho mude. O Coroid pergunta antes, e nada é excluído.

Decidindo uma mesclagem

Um plano pronto para mesclagem abre na tela de decisão: há quanto tempo está aguardando, o que a mesclagem fará ("Mesclar colocará no ramo main do coroid-expo."), uma linha de fatos (suas tarefas, suas verificações, o pull request) e seções fechadas com as alterações, tudo o que vale a pena saber, as evidências e como chegou até ali. Aprovar e mesclar pergunta mais uma vez antes de mesclar; Outras opções inclui Solicitar alterações, Perguntar sobre isso, o pull request e o nome do ramo.

Como foi executado um trabalho

Abra uma tarefa e ela será exibida como sua thread: uma frase sobre o que aconteceu (ou o que está acontecendo agora), uma linha de fatos (critérios atendidos, tempo, custo, rodadas de QA), um rastreador com Pedido, Planejado, Construído, Verificado e Entregue, e as mensagens que levaram a isso: o pedido, cada ordem de trabalho, o que o Desenvolvedor e a QA relataram, as respostas da sua equipe e como terminou. Quando a QA devolveu o trabalho, essas rodadas são agrupadas em uma linha que pode ser aberta.

Escolha uma mensagem para ver seu registro: a ordem de trabalho, as verificações e a execução com seu modelo, tokens e tempo, com acesso ao histórico completo. "Sobre este trabalho" contém a especificação, quem solicitou, o plano, qualidade e custo.

Um plano é lido da mesma forma: suas fases como mapa, cada tarefa com seu desfecho e quantas tarefas a QA aprovou na primeira tentativa.

O trabalho interrompido é indicado em vermelho, com o que é seguro ("Seguro: o main não foi alterado."), o motivo da interrupção (suas últimas mensagens e a falha registrada) e Tentar novamente agora.

No final de uma thread você pode:

  • Responder, e mencionar pessoas com @; elas receberão uma notificação com um link.
  • Perguntar ao assistente sobre o trabalho. Ele lê a thread para responder ("Por que foi devolvido?") e vincula ao que encontrou.
  • Compartilhar compartilhe com pessoas da sua organização; elas receberão uma notificação com o link. Ninguém fora da sua organização poderá abrir o conteúdo.
  • Copiar como resumo breve: um pequeno resumo com o resultado, os fatos e o link, para colar em qualquer lugar.

Acompanhando a execução de uma tarefa

Abra uma tarefa em execução para acompanhar em tempo real: os passos realizados, as ferramentas utilizadas, os arquivos alterados e a saída dos testes à medida que são gerados.

Vale a pena fazer isso algumas vezes no início. Acompanhar duas ou três tarefas do início ao fim ensina mais sobre como redigir uma boa especificação do que qualquer quantidade de documentação — você vê exatamente onde o agente precisou fazer suposições.

Depois disso, pare de acompanhar. As notificações informarão quando algo exigir sua intervenção.

Intervenção

Você pode pausar, cancelar ou enviar de volta uma tarefa em execução com comentários. Veja Quando uma tarefa trava ou falha para saber quando cada opção é adequada.

Automação

O trabalho não começa apenas quando alguém digita uma descrição:

  • Automações iniciam o trabalho conforme um cronograma ou quando algo acontece, como a abertura de um pull request. Elas estão listadas em Automações.
  • Agendas executam tarefas de forma recorrente.
  • Gatilhos reagem a eventos da plataforma.
  • Relatórios resumem o que aconteceu, de acordo com um cronograma.

Nesta seção