Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Passo 7 · 8 min de leitura

Modelos de contribuição

Quem pode mudar um design system, e como. Os três modelos de time por trás da maioria dos sistemas, um caminho de contribuição com uma régua que as pessoas conhecem antes de começar, e como dizer não sem perder quem pediu.

Um pátio ferroviário de maquete sobre uma base: uma linha principal e três desvios que se juntam a ela, cada um com um para-choque e um vagão esperando. Aponte para um desvio: o vagão desce, passa pelo entroncamento e entra na linha principal, enquanto os vagões dos outros desvios avançam um pouco. Este passo é isso: muitos times constroem, e o sistema precisa de um caminho claro para o trabalho deles entrar no núcleo, um de cada vez. Este passo tem três lições: modelos de contribuição, descontinuação e mudanças que quebram compatibilidade, e sistemas multimarca e multiproduto.Ilustração: Marcus Andrey, desenhada com Hairline (MIT, Lucas Marques).

Um design system que só o próprio time consegue mudar vai estar sempre atrás dos produtos que atende. Quem encontra as lacunas primeiro são os designers e devs de produto, com prazo, com uma tela de verdade na frente. A contribuição é o caminho para as correções deles chegarem a todo mundo, em vez de ficarem num produto só, como uma bifurcação silenciosa. A governança é o conjunto de regras que torna isso seguro.

O que você vai conseguir fazer depois de ler:

  • Nomear os três modelos de time e dizer qual é o seu
  • Desenhar um caminho de contribuição, do pedido ao lançamento
  • Definir uma régua para contribuições que as pessoas conhecem antes de começar
  • Dizer não a uma contribuição e continuar com quem contribuiu

1. Quem decide: três modelos de time

Solitário

Quem decide
O time que construiu, para o próprio produto
Funciona quando
Há um produto só, ou os outros aceitam seguir
Quebra quando
Outros times precisam de algo que os donos não precisam, e começam a fazer o próprio

Centralizado

Quem decide
Um time do sistema que não entrega telas de produto
Funciona quando
Há orçamento para o time, e os produtos precisam de uma base comum rápido
Quebra quando
O time perde contato com os problemas reais dos produtos e vira uma fila

Federado

Quem decide
Um grupo tirado dos times de produto, com tempo reservado para isso
Funciona quando
Pessoas seniores conseguem dar horas de verdade, e alguém ainda coordena
Quebra quando
"Todo mundo é dono" vira ninguém ter tempo
Três jeitos de organizar as pessoas por trás de um sistema, a partir de Nathan Curtis. O modelo decide quem pode dizer sim a uma contribuição, então escolha o modelo antes de escrever o processo. A maioria dos times acaba com um núcleo central pequeno mais contribuidores federados.Diagrama: Marcus Andrey, CC BY 4.0. Nomes dos modelos de Nathan Curtis, "Team Models for Scaling a Design System" (EightShapes, 2015).

Em 2015, Nathan Curtis descreveu três jeitos de as organizações montarem o time de um sistema (Team Models for Scaling a Design System, EightShapes):

  • Solitário. Um time de produto constrói uma biblioteca para si e deixa os outros usarem. Foi assim que o Harbour começou: duas pessoas no app de reservas da Tidewater. O problema aparece quando o console da equipe precisa de algo que o time de reservas não precisa, e ninguém tem motivo para construir.
  • Centralizado. Um time dedicado atende todos os produtos. Ele enxerga o portfólio inteiro, mas não entrega telas de produto, então pode perder contato com as restrições reais e virar uma fila.
  • Federado. Designers de vários times de produto tomam as decisões do sistema juntos. Isso mantém o sistema perto do trabalho real, mas só se essas pessoas tiverem tempo de verdade para isso.

Você não precisa escolher um para sempre. A maioria dos sistemas que duram acaba com um núcleo central pequeno, dono da qualidade e dos lançamentos, e contribuidores nos times de produto. O próprio Curtis escreveu que as organizações estavam saindo de times solitários e centralizados "towards a more federated approach" (rumo a uma abordagem mais federada).

O modelo importa para esta lição porque responde a uma pergunta: quem pode dizer sim? Escreva isso antes de escrever qualquer processo.


2. Tipos de contribuição

Nem toda contribuição é um componente novo. O Carbon, o sistema da IBM, separa componentes novos de melhorias nos existentes: evoluções, atualizações do kit de design, documentação, correções de bugs (Carbon, Contributing). Dimensione o processo pelo tamanho da mudança:

Contribuição Exemplo no Harbour Processo
Correção O anel de foco do Button some no modo escuro Um pull request ou uma branch no Figma, revisado por uma pessoa
Documentação Adicionar "Quando não usar" ao Tag Editar a página de documentação, uma revisão
Evolução O Notice precisa de um slot de ação Proposta curta, depois a revisão normal
Componente ou padrão novo Um seletor de quantidade para passageiros e carros O caminho completo abaixo

Se corrigir um erro de digitação leva os mesmos cinco passos de um componente novo, as pessoas param de corrigir erros de digitação.


3. Um caminho com uma régua conhecida

  1. 1Propor

    A necessidade, a evidência e onde ela aparece. Ainda sem design.

    Qualquer designer ou dev
  2. 2Triagem

    Serve para mais de um time? Já não existe no Harbour? A maioria dos pedidos para ou se junta a outro aqui.

    Time do sistema, em até uma semana
  3. 3Construir

    Design e código juntos, com tokens, estados e acessibilidade desde o início.

    Quem propôs, em par com o time do sistema
  4. 4Revisar

    Testado com usuários? Reaproveita o que existe? Funciona em mais de um produto?

    Time do sistema mais uma pessoa de produto
  5. 5Lançar

    Biblioteca, pacote, página de documentação, linha no changelog e um agradecimento com o nome de quem contribuiu.

    Time do sistema

Pedidos recusados ou adiados voltam para quem propôs com o motivo, e continuam visíveis no backlog.

Como uma contribuição entra no Harbour, em cinco passos. O passo 2 faz as duas perguntas de proposta do GOV.UK (útil, única) e o passo 4 as três de publicação (usável, consistente, versátil), então a régua é conhecida antes de alguém começar.Diagrama: Marcus Andrey, CC BY 4.0. Critérios do GOV.UK Design System (contribution criteria).

O GOV.UK Design System publica os seus critérios de contribuição, divididos em duas fases. Para ser aceita para desenvolvimento, uma proposta precisa ser útil (há evidência de que muitos times ou serviços precisam dela) e única (não repete algo que já está no sistema). Para ser publicada, precisa ser usável (testada em pesquisa com uma amostra representativa de usuários, incluindo pessoas com deficiência), consistente (reaproveita estilos e componentes existentes) e versátil (funciona numa variedade de serviços) (GOV.UK Design System, Contribution criteria).

Dois detalhes do processo deles valem a cópia:

  • Proponha antes de desenhar. O GOV.UK pede que as pessoas apresentem a ideia e a evidência da necessidade dos usuários e que, nessa fase, "avoid spending time working on a specific design or writing code" (evitem gastar tempo com um design específico ou escrevendo código) (Propose a component or pattern). Isso protege quem contribui: se a resposta for "use o Notice", ninguém perdeu uma semana.
  • Um backlog público. As ideias vão para uma lista compartilhada, onde as pessoas podem somar evidência a uma proposta que já existe, em vez de abrir uma nova.

4. Dizer não, bem

A maioria dos pedidos não deve virar componente novo. Isso é o sistema funcionando, não falhando. Brad Frost sugere esperar até um segundo time precisar de um padrão antes de adicioná-lo, para a biblioteca não virar um "Velho Oeste" (Atomic Design, chapter 5).

Um bom não tem três partes:

  1. O motivo, ligado aos critérios: "Não é único: o Notice com tone="warning" já cobre isso."
  2. Um caminho: use isto, ou construa localmente e a gente olha de novo quando um segundo time pedir.
  3. Um rastro: o pedido continua no backlog, então a próxima pessoa que precisar soma evidência em vez de começar do zero.

A pesquisa da Sparkbox de 2022 com times de design system mostrou que só 33% das pessoas mantenedoras estavam satisfeitas com o jeito como aceitam contribuições, e que quem considerava o próprio sistema um sucesso tinha mais chance de ter um processo de contribuição (Sparkbox Design Systems Survey 2022). É uma amostra autosselecionada de 219 pessoas, então leia como um sinal, não como uma lei. O sinal é claro o bastante: o processo é difícil, e vale a pena ter.


5. Crédito e trabalho em par

Contribuir custa aos times de produto um tempo pelo qual eles não são avaliados. Devolva:

  • Faça par. Alguém de design ou de engenharia do sistema trabalha junto com quem contribui, para o trabalho atingir a régua sem rodadas infinitas de revisão.
  • Dê nome às pessoas. Coloque o nome de quem contribuiu no changelog e na página de documentação.
  • Retribua. O modelo federado de Curtis termina com uma regra fácil de esquecer: a contribuição deveria dar aos times alguma autonomia em troca.

6. Erros comuns

  • Nenhuma resposta escrita para "quem pode dizer sim?", então todo pedido termina numa reunião.
  • Um processo pesado para tudo, de erros de digitação a padrões novos.
  • Pedir designs prontos na proposta e depois recusá-los.
  • Dizer não sem motivo nem alternativa, e ganhar uma bifurcação no lugar.
  • Um backlog que ninguém de fora do time do sistema consegue ver.

7. Vocabulário

Termo Significado
Governança As regras sobre quem muda o sistema, como, e como as mudanças são anunciadas
Contribuição Uma mudança no sistema feita por alguém de fora do time principal
Solitário, centralizado, federado Três modelos de time: um produto é dono, um time dedicado é dono, os times de produto são donos juntos
Triagem A primeira checagem de um pedido: é útil e ainda não existe?
Bifurcação (fork) Uma cópia local de um componente que vai se afastando do sistema

8. Experimente (sem ferramentas)

  1. Lembre a última vez que alguém do seu time construiu um componente que o sistema não tinha.
  2. Passe esse caso pelos cinco passos da figura. Onde ele teria parado?
  3. Escreva o não, ou o sim, em uma linha, que ele deveria ter recebido.

Perguntas para refletir: Quem pode dizer sim a uma mudança no seu sistema hoje, de verdade? O que um designer de produto perde ao contribuir, e o que poderia ganhar?


9. Se você já pratica

  • Publique os critérios e o backlog onde os times de produto possam ver.
  • Acompanhe quanto tempo os pedidos levam da proposta à decisão. Se forem meses, as pessoas vão parar de pedir.
  • Ofereça uma "via rápida" para correções e documentação, revisada por uma pessoa em poucos dias.

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo

Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.

Relacionadas

Conduza uma revisão de contribuição · Descontinuação e breaking changes · Trazer os times para o sistema · Movimento na governança do design system · Financiar e montar o time de um design system · Processo de contribuição · Modelos de governança de design system

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar