logo da vtnorton

📰 Outras postagens

Como implementar diversidade na sua documentação

Como implementar diversidade na sua documentação

por vítor norton, em 06/07/2023

Como implementar diversidade na sua documentação

Durante uns 10 meses trabalhei como Tech Writer, ou como eu gostava de chamar “escritor de manual de instruções para devs”, e durante esse período queria fazer algo para instaurar o comunismo de dentro de um banco fazer algo com o meu privilégio homem branco.
Na empresa que trabalhava tínhamos diversas APIs relacionadas a contas bancárias e com isso precisamos ter váaarios exemplos, com dados de pessoas e coisa do tipo, nós usávamos uns dados falsos do Peter Parker - sim o homem aranha, porém tínhamos dois problemas com isso:
  1. Não sentia que o Peter Parker era um bom personagem para isso... qualé gente, é um ótimo filme da Marvel, mas é personagem gringo, homem hétero top, cis, branco.. Bora colocar uma pessoa brasileira, mulher, feminista, na nossa doc e colocar nosso país no mapa!
  1. Nem todas as páginas estavam com os dados do Peter Parker.
Então, com tudo isso paramos e olhamos nossos personagens, pensamos no folclore, nas obras de Drummond e Fernando Pessoa e até mesmo nas novelas da Globo, mas nenhum personagem seria tão f*d@ quanto a Nísia Floresta.
notion image
Essa mulher eh foda, veio do Rio Grande do Norte lá em 1800 e "guaraná com rolha", foi uma importante educadora e queríamos dar o destaque a ela que lutou pelos direitos das mulheres (inclusive de votar)!
NÃO PARA POR AÍ
Como também documentamos transações entre contas diferentes, criamos uma outra personagem, a Maria Quitéria de Jesus!
Ela foi a primeira mulher no exército brasileiro. Essa baiana arretada precisou fingir ser homem pra entrar no exército! Olha que loco!
notion image
Então, nós atualizamos toda a nossa documentação com estas duas personagens da história nacional, que a gente quase não ouve falar.
O Peter Parker continua nos filmes da Marvel recebendo seus bilhões, e a gente restaura um pouco da história do Brasil com elas.
Espero que tenham curtido, e que consigam achar todos os easter eggs que colocamos na documentação das duas personagens acima. A doc é essa daqui: https://docs.bankly.com.br
Amo que o meu time super topou a ideia e me ajudou a colocar em prática! Obrigado Cris, Jade, Mari e Eriquinha! 😘