Organizando um workspace

Uma pasta é um contêiner na barra lateral que agrupa workflows. É a principal forma de organizar um workspace quando ele passa a ter mais do que alguns workflows. Pastas funcionam como pastas no sistema de arquivos do desktop: aninham, recolhem e você as organiza por convenção para que a estrutura mostre onde as coisas vivem.

Uma lista plana de vinte workflows é difícil de varrer, mas agrupar os mesmos vinte sob três ou quatro pastas de nível superior te dá um mapa de onde tudo fica.

As partes de uma pasta

Aqui vai um exemplo: uma pasta chamada Customer Deployments, colorida de vermelho, com cinco workflows e duas subpastas.

Nome

Um nome é o rótulo que você dá a uma pasta. É texto livre, sem formato imposto, então a convenção é sua. Prefira nomes que leiam como categorias, não como rótulos pontuais: Internal, Customer-Facing, Ops. Nossa pasta de exemplo se chama Customer Deployments. A nomenclatura é coberta em Convenções abaixo.

Cor

Uma cor é um valor hex atribuído a uma pasta para agrupamento visual, mostrado como um ponto ao lado do nome. O padrão é cinza (#6B7280) e você pode alterá-lo no menu da pasta. A cor é a forma mais rápida de ler a barra lateral de relance. Reserve uma cor por categoria de nível superior (vermelho para produção, cinza para rascunhos) para achar o ramo certo antes de ler qualquer nome. Nosso exemplo é vermelho (#EF4444).

Aninhamento

Uma pasta pode ficar dentro de outra. A interna é uma subpasta, e a estrutura é uma árvore: uma pasta de nível superior não tem pai, uma subpasta aponta para a pasta que a contém, e essa cadeia pode ir tão fundo quanto você precisar. Nosso exemplo, Customer Deployments, tem duas subpastas e fica sob uma pasta Production.

Prefira árvores rasas. Dois ou três níveis (Production > Customer A > Deployments) continuam legíveis. Mais fundo que isso e você acaba rolando a barra lateral em vez de varrê-la.

Ordem

As pastas aparecem em uma ordem definida, de cima para baixo, que você controla arrastando-as na barra lateral. Arraste uma pasta para cima ou para baixo para reordená-la no nível dela, ou solte sobre outra pasta para movê-la para dentro como subpasta. Ordem também é convenção: coloque no topo as pastas que o time toca todo dia.

Bloqueio

Uma pasta bloqueada é somente leitura: seus workflows podem ser visualizados, 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 sem alterá-los por acidente. Bloquear uma pasta também bloqueia tudo dentro dela, então um pai bloqueado protege suas subpastas e workflows de uma vez. Quem pode bloquear e desbloquear segue as funções e permissões do workspace.

Arquivamento

Arquivar uma pasta a remove da barra lateral ativa sem excluí-la. Uma pasta arquivada some da visualização normal, e você a restaura quando precisar de novo. Use o arquivamento para limpeza: um engajamento de cliente concluído ou um experimento aposentado sai da barra lateral, mas continua recuperável. Não há exclusão permanente no menu da pasta, então arquivar é a forma segura de tirar algo do caminho.

Convenções

Convenções de nomenclatura tornam a estrutura legível para quem não a construiu. Nada aqui é imposto, então o valor vem de aplicar uma regra de forma consistente no workspace.

• Agrupe por público ou função no nível superior. Uma divisão comum é Internal, Customer-Facing e Ops. Alguém novo encontra o ramo certo só pelos nomes de nível superior.
• Nomeie pastas como categorias, workflows como ações. Uma pasta é um substantivo (Billing); um workflow é o que ela faz (Send overdue reminder). O caminho da pasta mais o nome do workflow deve ler como uma frase.
• Use cor no nível superior, nomes em tudo abaixo. A cor carrega o agrupamento grosseiro; os nomes carregam o detalhe. Misturar os dois em todos os níveis vira ruído.
• Espelhe a convenção em todo lugar. As mesmas palavras de categoria que você usa nas pastas valem a pena reutilizar em tabelas, segredos e integrações, para o time aprender um vocabulário em vez de três.

Um workspace ou vários

Pastas organizam dentro de um workspace. Um workspace separado traça um limite rígido: recursos nunca o cruzam, e o acesso é concedido por workspace. Crie um novo workspace quando precisar desse limite, não só de um agrupamento mais limpo.

• Agrupe em pastas quando tudo pertence ao mesmo time e às mesmas regras de acesso, e você só quer navegar com mais facilidade.
• Separe em workspaces quando um conjunto de trabalho precisa dos próprios membros, das próprias integrações e segredos, ou do próprio isolamento. O caso clássico é um workspace por cliente, em que o workspace em si é o entregável que o cliente possui.

Veja Fundamentos do workspace para o que o limite abrange e Funções e permissões para como membros e assentos funcionam entre workspaces.

Próximos passos