{"id":2121,"date":"2016-01-14T01:17:16","date_gmt":"2016-01-14T01:17:16","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2121"},"modified":"2016-01-14T01:17:16","modified_gmt":"2016-01-14T01:17:16","slug":"contribute-to-open-source-projects","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/contribute-to-open-source-projects\/","title":{"rendered":"Contribui\u00e7\u00e3o para projetos e c\u00f3digos de c\u00f3digo aberto"},"content":{"rendered":"

Tradicionalmente, a TI executava software comercial de prateleira, enquanto os data centers executavam hardware Unix propriet\u00e1rio e servidores Windows baseados em x86. No entanto, recentemente, o ambiente de computa\u00e7\u00e3o do usu\u00e1rio final foi interrompido pelo advento dos smartphones e tablets, com o Linux se tornando cada vez mais uma for\u00e7a dominante no data center. Sem mencionar que houve previs\u00f5es de analistas da IDC em agosto de 2015, observando que j\u00e1 h\u00e1 uma mudan\u00e7a para sistemas de c\u00f3digo aberto como o Couchbase e o Couchbase Mobile no mercado de servidores e dispositivos m\u00f3veis.<\/p>\n

Contribuir com o c\u00f3digo-fonte aberto n\u00e3o \u00e9 t\u00e3o assustador quanto parece. Em primeiro lugar, a comunidade de c\u00f3digo aberto \u00e9 grande e diversificada, com pessoas trabalhando juntas em problemas comuns.\u00a0 Stackoverflow<\/a> \u00e9 um exemplo de como as mentes coletivas s\u00e3o capazes de resolver problemas relacionados mais rapidamente e compartilhar as descobertas di\u00e1rias. Os benef\u00edcios s\u00e3o que voc\u00ea pode obter feedback direto de uma vasta comunidade de especialistas com diferentes n\u00edveis de habilidade e, ao mesmo tempo, criar um sistema de suporte de campe\u00f5es.\u00a0<\/p>\n

R\u00e1pido<\/h3>\n

<\/p>\n

At\u00e9 mesmo a Apple abriu sua linguagem de codifica\u00e7\u00e3o, R\u00e1pido<\/a>e, assim, os desenvolvedores de fora da Apple poder\u00e3o consultar o Swift e o contribuir para seu desenvolvimento<\/a> trazendo-o, assim, para novas plataformas, como Windows e Android. Outra vantagem \u00e9 que, por ser de c\u00f3digo aberto agora, voc\u00ea pode ver o roteiro do produto e evolu\u00e7\u00e3o do Swift<\/a> tamb\u00e9m para datas de lan\u00e7amento de recursos futuros.<\/p>\n

Primeiros passos<\/h3>\n

Isso n\u00e3o \u00e9 t\u00e3o assustador quanto parece. Muitas vezes, podemos acreditar que as \u00fanicas contribui\u00e7\u00f5es importantes nas quais os l\u00edderes de projetos de c\u00f3digo aberto est\u00e3o interessados s\u00e3o as extens\u00f5es de recursos ou as corre\u00e7\u00f5es de bugs importantes. Mas, na realidade, tudo o que \u00e9 necess\u00e1rio s\u00e3o algumas linhas de c\u00f3digo e come\u00e7ar aos poucos. Trabalhar com um conhecimento de dom\u00ednio que voc\u00ea j\u00e1 conhece permitir\u00e1 que voc\u00ea se aprofunde rapidamente e tamb\u00e9m ficar\u00e1 mais motivado a melhorar o projeto em geral. O outro benef\u00edcio \u00e9 aprender e adquirir novas habilidades de dom\u00ednio tamb\u00e9m. H\u00e1 muitos projetos dispon\u00edveis no GitHub com os quais voc\u00ea pode contribuir, como Leitor de livros eletr\u00f4nicos da Library For All,<\/a> ao mesmo tempo em que aprende novas tecnologias, como o React Native.\u00a0<\/p>\n

Relat\u00f3rios de problemas<\/h3>\n

Como voc\u00ea pode come\u00e7ar? Bem, uma maneira \u00e9 fazer parte do grupo coletivo que contribui com o c\u00f3digo-fonte, mas outra maneira \u00e9 procurar melhorar os t\u00edquetes de relat\u00f3rios de erros existentes. Essa \u00e9 uma oportunidade de contribuir preenchendo informa\u00e7\u00f5es \u00fateis e definindo o padr\u00e3o de qualidade dos relat\u00f3rios de erros. Uma estrat\u00e9gia de como fazer isso \u00e9:<\/p>\n

    \n
  1. Verifique se o problema ainda est\u00e1 ocorrendo<\/li>\n
  2. Descreva as etapas para reproduzir o problema<\/li>\n
  3. Fornecer informa\u00e7\u00f5es sobre a vers\u00e3o<\/li>\n
  4. Adicione trechos de c\u00f3digo, capturas de tela e registro de erros ou textos\u00a0<\/li>\n<\/ol>\n

    A chave aqui \u00e9 ajudar a fechar um problema existente e fornecer detalhes claros ajudar\u00e1 a resolver o t\u00edquete aberto, melhorando assim a experi\u00eancia geral e o c\u00f3digo. Uma vez identificado, voc\u00ea tamb\u00e9m pode fazer refer\u00eancia a membros espec\u00edficos da equipe do projeto para investigar os problemas mais a fundo. Abaixo, voc\u00ea pode ver o Problemas pendentes do Couchbase Mobile Android<\/a> que est\u00e1 sendo relatado pelos meus usu\u00e1rios na comunidade.\u00a0 <\/a><\/p>\n

    Documenta\u00e7\u00f5es do desenvolvedor<\/h3>\n

    Os desenvolvedores dependem de \u00f3timas documenta\u00e7\u00f5es para aprender e entender as tecnologias. \u00c9 o primeiro lugar que os desenvolvedores visitam antes de se aprofundar e ter \u00f3timas documenta\u00e7\u00f5es \u00e9 fundamental para que os desenvolvedores adotem uma tecnologia rapidamente. Essa \u00e9 outra \u00e1rea em que voc\u00ea pode contribuir muito, pois os documentos do projeto nem sempre s\u00e3o mantidos no mesmo ritmo que o restante do projeto. Voc\u00ea pode ajudar a esclarecer as coisas para si mesmo e para os outros desenvolvedores:<\/p>\n

      \n
    1. Atualizar a descri\u00e7\u00e3o dos m\u00e9todos<\/li>\n
    2. Forne\u00e7a um exemplo de m\u00e9todo e uso<\/li>\n
    3. Adicionar diagramas<\/li>\n
    4. Corrigir erros de digita\u00e7\u00e3o e atualizar os n\u00fameros de vers\u00e3o<\/li>\n<\/ol>\n

      Assim como o Couchbase Mobile Android README.md<\/a> suas contribui\u00e7\u00f5es nas documenta\u00e7\u00f5es ou nos guias ser\u00e3o de grande ajuda para o sucesso dos desenvolvedores, pois esse ser\u00e1 o principal recurso com o qual os desenvolvedores interagem diariamente.<\/p>\n

      <\/a><\/p>\n

      Resolu\u00e7\u00e3o de problemas<\/h3>\n
      \n

      \u00c9 aqui que voc\u00ea pode combinar tudo o que aprendeu com as quatro op\u00e7\u00f5es acima na contribui\u00e7\u00e3o definitiva de c\u00f3digo aberto: o patch de bug. Obviamente, n\u00e3o se sinta pressionado a solucionar todos os bugs que encontrar, mas, se tiver disponibilidade, tente encontrar a solu\u00e7\u00e3o. Mesmo que n\u00e3o encontre a corre\u00e7\u00e3o, relate suas descobertas sobre o problema existente ou abra um novo problema com detalhes completos sobre tudo o que tentou.<\/p>\n

      Quando voc\u00ea encontrar a corre\u00e7\u00e3o, lembre-se de que as melhores corre\u00e7\u00f5es s\u00e3o as menos perturbadoras poss\u00edveis. Especificamente, sua corre\u00e7\u00e3o deve introduzir o m\u00ednimo poss\u00edvel de c\u00f3digo novo<\/strong>e qualquer novo c\u00f3digo deve ser escrito no mesmo estilo que o restante da base de c\u00f3digo.<\/strong> Mantenha seu escopo pequeno; sua pull request deve tratar de um \u00fanico problema limitado, com altera\u00e7\u00f5es m\u00ednimas em geral.<\/p>\n

      Quando estiver pronto para abrir sua pull request, certifique-se de cobrir o seguinte:<\/p>\n