top of page
  • Foto do escritorRan Isenberg

Doação de código-fonte aberto 101


Noções básicas sobre doação de código 101
Noções básicas sobre doação de código 101

O modelo de código aberto é um modelo de desenvolvimento de software descentralizado que incentiva a colaboração aberta - Wikipédia. Código aberto é o código fonte que é disponibilizado gratuitamente para possível modificação e redistribuição. Os produtos incluem permissão para usar o código fonte, [1] documentos de design, [2] ou conteúdo do produto.

Doações de código têm muitas vantagens e, no meu blog anterior , apresentei como uma doação de código mudou minha carreira e me fez ser promovido no trabalho .

Ele pode fazer o mesmo por você ou até mais; a decisão é sua!

Então, neste blog, abordo dicas e truques para você começar no maravilhoso mundo da doação de código aberto.

Este blog pressupõe que você esteja familiarizado com conceitos como GitHub , git e Pull Requests .

 

Regras pessoais de doação de código

O processo de doação de código pode ser dividido em duas partes: descobrir o que fazer e, então, realizar o trabalho propriamente dito.

Em muitos casos, encontrar um projeto para doar código é muito mais complicado do que a doação em si.

Além disso, doações de código exigem dedicação e tempo, pois muitas vezes você fará isso às custas do seu tempo livre após o expediente.

Por essas razões, as diretrizes abaixo me ajudaram a definir minhas expectativas e a controlar meus limites de tempo.


Noivado

Encontre uma área que lhe interesse; ela o manterá engajado e motivado.

Tente melhorar o software que você usa regularmente; isso torna a doação de código mais pessoal e significativa.


Fator Diversão

Você está fazendo isso para espalhar conhecimento e ajudar outras pessoas, mas também por diversão. Se não estiver se divertindo ou se isso se tornar muito trabalhoso, não faça.


O tamanho não importa

Sua doação pode ser tão pequena quanto um compromisso de uma linha.

Desde que ajude a comunidade ou resolva um problema, serve ao propósito.


Equilíbrio entre trabalho e vida pessoal

A doação de códigos não é seu trabalho principal. Você já tem um trabalho, vida pessoal e familiar para administrar. Mantenha-o equilibrado e administre seu tempo. Por favor, não exagere.

Dedique algumas horas durante uma semana a essa nova experiência.

Algumas empresas podem lhe dar tempo durante o horário de trabalho para aprender e doar códigos. Se não, então você precisa fazer isso no seu tempo livre.

Mas, por favor, não exagere, pois você não está contratando.

Tenha em mente que é muito comum que um PR leve várias semanas. Pode levar ainda mais tempo para que esse PR seja mesclado eventualmente, então vá com calma. Não se esqueça de que os mantenedores do repositório também fazem isso em seu tempo livre.

 

Como começar

Muitas pessoas querem doar código, mas não sabem por onde começar.

Aqui estão minhas diretrizes que ajudarão você a encontrar um projeto adequado no qual valha a pena investir seu tempo:

  1. Escolha um projeto que resolva aborrecimentos ou problemas que você encontra no seu trabalho diário.

  2. Escolha um projeto no qual você esteja interessado e apaixonado e use-o no seu trabalho diário.

  3. Escolha um projeto escrito em uma linguagem de programação de sua especialidade. Foque na doação, não na linguagem.

  4. Escolha um projeto ativo onde os mantenedores respondem ativamente aos problemas e os lançamentos são relativamente frequentes. Você não quer que seu PR espere por meses.

  5. Escolha um projeto com diretrizes claras de doação/contribuição de código (procure por um arquivo CONTRIBUTING.md). Você não quer passar noites tentando descobrir como configurar um ambiente de desenvolvedor. Tenha em mente que alguns projetos não apreciam doações de fora ou são muito rigorosos sobre elas.

  6. Procure por edições que tenham rótulos marcados como “boa primeira edição”, conforme descrito aqui .

Eureka, encontrei um projeto!

OK. Então você encontrou um projeto em potencial. E agora?

Tente analisar os problemas atuais em aberto.

Talvez você tenha uma ideia ou um problema que o incomoda; abra um novo issue e garanta que você siga as diretrizes do repositório para abrir um issue (arquivos CONTRIBUTING ou Readme). Talvez procure uma chamada para desenvolvedores ou RFCs ou tente se envolver em uma discussão.

Algumas ideias para uma primeira contribuição fácil são:

  1. Traduzindo o guia do repositório/arquivo leia-me.

  2. Adicionar exemplos de saída ou código para a documentação.

  3. Corrigir erros de digitação ou gramática.

Se você ficar preso, tente encontrar os mantenedores no Slack/Twitter/Discord e peça ajuda.


Dicas legais

Uma última dica importante, embora óbvia, não, repito, não use nenhum código da empresa ou bibliotecas internas. Qualquer código que você escrever deve ser escrito do zero, e não deve se assemelhar a nenhuma patente ou produto da empresa.

No entanto, não sou advogado (e não assumo nenhuma responsabilidade por nada que você doar), então consulte seu departamento jurídico sobre o código de doação específico.


Paciência é a chave

Depois que a construção do seu PR estiver verde, não espere que ele seja mesclado tão rápido. Pode levar tempo.

Os mantenedores também têm trabalhos. Eles podem ter uma sugestão sobre a experiência do usuário, APIs e o código em si.

Seja paciente e tente aprender com a experiência deles. Não discuta demais sobre as solicitações de mudança; nunca é benéfico ou *tão* importante.

É isso; boa codificação!


コメント


bottom of page