Uma pasta é um contêiner na sidebar que agrupa workflows. É a principal forma de organizar um workspace depois que ele passa de um punhado de workflows. As pastas funcionam como as pastas de um sistema de arquivos: elas se aninham, se recolhem e você as arranja por convenção, de modo que a estrutura já diga onde as coisas estão.
Uma lista plana de vinte workflows é difícil de percorrer, mas agrupar esses mesmos vinte em três ou quatro pastas de primeiro nível te dá um mapa de onde tudo mora.
As partes de uma pasta
Veja um exemplo: uma pasta chamada Customer Deployments, na cor vermelha, com cinco workflows e duas subpastas.
Nome
O nome é o rótulo que você dá a uma pasta. É texto simples, sem formato obrigatório, então a convenção é você quem define. Escolha nomes que soem como categorias, não como rótulos pontuais: Internal, Customer-Facing, Ops. Nossa pasta de exemplo se chama Customer Deployments. A nomenclatura é tratada em Convenções, abaixo.
Cor
A cor é um valor hexadecimal atribuído a uma pasta para agrupamento visual, mostrado como um ponto ao lado do nome. O padrão é cinza (#6B7280) e você pode mudá-la pelo menu da pasta. A cor é a maneira mais rápida de ler a sidebar de relance. Reserve uma cor por categoria de primeiro nível (vermelho para produção, cinza para rascunhos) para encontrar o ramo certo antes de ler um único nome. Nosso exemplo é vermelho (#EF4444).
Aninhamento
Uma pasta pode ficar dentro de outra. A de dentro é uma subpasta, e a estrutura é uma árvore: uma pasta de primeiro nível não tem pai, uma subpasta aponta para a pasta que a contém, e essa corrente pode ir tão fundo quanto você precisar. Nosso exemplo, Customer Deployments, tem duas subpastas e fica ele mesmo dentro de uma pasta Production.
Comece com árvores rasas. Dois ou três níveis (Production > Customer A > Deployments) continuam legíveis. Mais fundo do que isso e você passa a rolar a sidebar em vez de percorrê-la.
Ordem
As pastas aparecem em uma ordem definida, de cima para baixo, que você controla arrastando-as na sidebar. Arraste uma pasta para cima ou para baixo para reordená-la dentro do seu nível, ou arraste-a sobre outra pasta para movê-la para dentro como subpasta. A ordem também é uma convenção: coloque no topo as pastas que o time usa todos os dias.
Bloqueio
Uma pasta bloqueada é somente leitura: seus workflows podem ser vistos, mas não editados. O bloqueio vem desligado por padrão. Bloqueie uma pasta Production para que os membros possam abrir e executar os workflows dela sem alterá-los por acidente. Bloquear uma pasta também bloqueia tudo que está dentro dela, então um pai bloqueado protege suas subpastas e os workflows delas de uma só vez. Quem pode bloquear e desbloquear segue os papéis e permissões do workspace.
Arquivamento
Arquivar uma pasta a remove da sua sidebar ativa sem excluí-la. Uma pasta arquivada sai da visualização normal, e você a restaura quando precisar dela de novo. Use o arquivamento para faxina: um projeto de cliente concluído ou um experimento encerrado sai da sidebar, mas continua recuperável. Não existe exclusão permanente no menu da pasta, então arquivar é a forma segura de tirar algo do caminho.
Convenções
Convenções de nome tornam a estrutura legível para quem não a construiu. Nada aqui é obrigatório, então o valor vem de aplicar uma regra de forma consistente em todo o workspace.
- Agrupe por público ou função no primeiro nível. Uma divisão comum é
Internal,Customer-FacingeOps. Quem chega agora encontra o ramo certo só pelos nomes de primeiro nível. - Nomeie pastas como categorias e workflows como ações. Uma pasta é um substantivo (
Billing); um workflow é algo que ela faz (Send overdue reminder). O caminho da pasta mais o nome do workflow devem se ler como uma frase. - Use cor no primeiro nível e nomes em tudo abaixo dele. A cor carrega o agrupamento grosso; os nomes carregam o detalhe. Misturar os dois em todos os níveis vira ruído.
- Espelhe a convenção em todo lugar. Vale reaproveitar as mesmas palavras de categoria das pastas em tables, secrets e integrações, para que o time aprenda um vocabulário em vez de três.
Um workspace ou vários
As pastas organizam dentro de um workspace. Um workspace separado traça um limite rígido: os recursos nunca o atravessam, e o acesso é concedido por workspace. Recorra a um novo workspace quando você precisar desse limite, não apenas de um agrupamento mais arrumado.
- Agrupe em pastas quando tudo pertence ao mesmo time e às mesmas regras de acesso, e você só quer navegar com mais facilidade.
- Divida em workspaces quando um conjunto de trabalho precisa dos próprios membros, das próprias integrações e secrets, ou do próprio isolamento. O caso clássico é um workspace por cliente, em que o próprio workspace é a entrega que o cliente possui.
Veja Fundamentos de workspace para saber o que o limite abrange e Papéis e permissões para entender como membros e assentos funcionam entre workspaces.