Projeto · Dezembro de 2022
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.