Outras maneiras de contribuir com o código aberto neste Hacktoberfest

Existem outras maneiras de contribuir com o código aberto neste Hacktoberfest. Desde traduzir documentos até remover linguagem excludente ou condescendente.

Sou um grande fã das contribuições não técnicas para o código aberto. Elas podem ajudar a superar as barreiras de acessibilidade mais urgentes dos projetos de código aberto.

A Vonage está muito animada por ser parceira do Hacktoberfest 2020. Nós não somos novatos no mundo do código aberto, já que nossas bibliotecas, trechos de código e demonstrações estão todos no GitHub. Para mergulhar de cabeça nas comemorações, não deixe de conferir nossa página do Hacktoberfest para saber mais sobre tudo o que planejamos!

Lembre-se

Antes de começar a fazer suas contribuições, certifique-se de se inscrever no evento no site do DigitalOcean Hacktoberfest para que você possa acompanhar seu progresso. Assim que terminar suas contribuições, você poderá se inscrever para receber seu brinde. Este ano, você pode escolher entre uma camiseta de edição limitada e o plantio de uma árvore.

Traduções

Grande parte dos projetos de código aberto contém pouca ou nenhuma documentação em outros idiomas além do inglês. Um ótimo exemplo, que considero um modelo prático para documentação multilíngue, é o projeto First Contributions no GitHub, que oferece mais de 60 idiomas (incluindo minha tradução em “inglês pirata”).

Talvez sua primeira contribuição seja uma tradução da sua documentação favorita.

Reduzir o uso de linguagem condescendente

É muito fácil de usar muito fácil e outras expressões condescendentes na documentação. Percebeu o que eu fiz aí?

Além do tom condescendente e fácil, meu conselho é parar de usar “muito” de qualquer jeito, para melhorar seu vocabulário. É uma palavra tão usada que já perdeu todo o seu impacto. Em vez disso, há muitas maneiras melhores de dar ênfase ao que você quer dizer.

Quando lemos que algo é “fácil” ou “simples” e depois nos deparamos com problemas em uma biblioteca, isso pode rapidamente nos desmotivar.

Muitas pessoas de bem sugeriram evitar conscientemente o uso de linguagem condescendente, e Carol Stransky escreveu um ótimo guia sobre como eliminar a linguagem condescendente da documentação como resultado de seu trabalho para o Hacktoberfest em 2019.

Se for bem feita, sua solicitação de pull ficará parecida com esta criada no ano passado no repositório do Facebook/Jest.

Responder às perguntas

Se você já se familiarizou com uma biblioteca, talvez perceba que pode ajudar os mantenedores a lidar com a lista cada vez maior de perguntas.

As perguntas sobre uma biblioteca costumam se repetir, oferecendo a você várias maneiras de contribuir. Você pode achar que responder às perguntas é a melhor maneira de ajudar. Mas será que essas perguntas repetidas estão revelando lacunas na documentação?

Fechar tickets é uma coisa, mas e quanto a adicionar uma seção de perguntas frequentes ou um arquivo ao projeto?

Encontrar projetos

Muitas pessoas com quem conversei enfrentam dificuldades para encontrar projetos nos quais possam contribuir.

Já mencionei o projeto “Primeiras Contribuições” no GitHub, que explica passo a passo como se cadastrar como colaborador do projeto.

Somente para iniciantes é um projeto de Kent C. Dodds e Scott Hanselman para orientar as pessoas na busca por projetos nos quais possam contribuir.

Em aberto é uma forma de colaboradores e proprietários de projetos se conectarem em torno de projetos. Você pode pesquisar projetos com tags como first-timers, good first issue and up-for-grabs.

Encerramento

O Hacktoberfest tem como objetivo ajudar você a encontrar a confiança necessária para dar os primeiros passos no mundo do código aberto. E ainda ganhar uma camiseta.

"O código aberto é o passado, o presente e o futuro." - eu

Outras leituras

• Uma introdução ao Git

• A Vonage participa do Hacktoberfest 2020