Documentação de Design System: Em busca da plataforma ideal

Pesquisei e testei plataformas de documentação de Design System (ZeroHeight, Supernova) em busca da solução ideal pro Letras.

---

---

Como responsável por liderar o projeto de documentação do Design System no Letras, meu objetivo era estabelecer a plataforma oficial para centralizar regras e guias. O público-alvo incluía o time de Product Design e os times de desenvolvimento, garantindo fácil acesso a todas as informações essenciais do Design System.

Minha responsabilidade no projeto decorreu do meu forte interesse e habilidades em criar e organizar regras e guias no Design System. Enfrentei o desafio de mapear várias plataformas especializadas em documentação, considerando vantagens e desvantagens, planos gratuitos e pagos, e integração com ferramentas dos times de desenvolvimento.

Utilizando o Notion como ferramenta principal, centralizei feedbacks e suposições de reuniões. Após pesquisa detalhada, identifiquei critérios para escolher a plataforma, incluindo documentação de código, integração com Storybook e Figma, estrutura organizacional, visibilidade e facilidade de uso, compartilhamento fácil e sistema de tags para mapeamento de Tokens.

Optei pelo ZeroHeight, reconhecido pela documentação de Design Systems, adotado por empresas como Nubank, Meiuca e Hotmart (em 2022). No entanto, ao descobrir o Supernova, uma plataforma que tem como extra a sincronização de tokens, revisitei o projeto para considerar novas opções.

A análise mostrou que não há uma plataforma definitiva; cada empresa escolhe com base em suas necessidades. O Supernova se destacou pela integração com Figma e, principalmente, com Tokens.

Infelizmente, ao tentar documentar as regras de um componente no Supernova, nos deparamos com um problema crítico de desempenho. A plataforma se tornou inutilizável ao lidar com uma quantidade significativa de informações em uma única página, resultando em um impasse.

Com isso, voltamos à estaca zero, pois outra plataforma apareceu no nosso radar para ser avaliada, o Gitbook. O projeto voltará futuramente, visando uma solução ideal para garantir documentação eficaz e acessível a toda a equipe.