|
| 1 | +== Contribuidor Ethos |
| 2 | +No último segmento, descrevemos por que você gostaria de reutilizar componentes e se tornar ativo como Contribuidor. |
| 3 | +Este artigo compartilha as melhores práticas sobre como contribuir com sucesso suas mudanças no código base da equipe do host. |
| 4 | +Um colaborador do InnerSource tentando fazer uma contribuição para a equipe anfitriã é essencialmente um convidado em sua casa. |
| 5 | +Em geral, espera-se que um bom hóspede se comporte de uma certa maneira: |
| 6 | +Eles batem na porta. |
| 7 | +* Eles antecipam e seguem as regras da casa. |
| 8 | +* Eles entendem que eles não são o proprietário da casa e agir de acordo. |
| 9 | +Como essas expectativas se aplicam a projetos do InnerSource |
| 10 | +== = Entrando |
| 11 | +Ao visitar seus vizinhos, você provavelmente não entrará em sua casa sem bater ou tocar a campainha da porta, mesmo que a porta esteja aberta. |
| 12 | +Da mesma forma no InnerSource como um visitante você não poderá (ou convidado) se comprometer diretamente em qualquer repositório de código. |
| 13 | +Em vez disso, depois de fazer suas mudanças na base de código, você as enviará como uma solicitação pull. |
| 14 | +Assim como você não iria fazer grandes mudanças e o que você considera melhorias para seus vizinhos em casa, no InnerSource você vai antecipar e seguir as diretrizes de colaboração do projeto. |
| 15 | +Por sua vez, os seus anfitriões irão mostrar-lhe o caminho-no InnerSource que se traduz em responsáveis de confiança existentes gastando o seu tempo para orientar os convidados. |
| 16 | +E aquelas lindas festas de verão que você foi? |
| 17 | +Geralmente há algum planejamento com antecedência para escolher a data e hora certas, preparar comida suficiente ou ter a contribuição dos convidados. |
| 18 | +O mesmo acontece para mudanças maiores nos projetos InnerSource: um projeto provavelmente solicitará que você envie um problema descrevendo sua necessidade e sua solução proposta antes de fazer uma grande modificação. |
| 19 | +Gastar tempo em design inicial em vez de saltar para a direita na implementação economiza contribuidores de ter que refazer muito de seu trabalho. |
| 20 | +Compartilhar o progresso antecipadamente-mesmo quando ainda não está concluído-ajuda a equipe anfitriã a orientar o Contribuidor para uma solução melhor. |
| 21 | +Assim como a lei de correções inacabadas do https://cwiki.apache.org/confluence/display/solr/HowToContribute[Yonik explica: "Um patch meio cozido no Jira, sem documentação, sem testes e sem compatibilidade com versões anteriores é melhor do que nenhum patch." |
| 22 | +Isso implica que os projetos InnerSource não têm valor na comunicação cara a cara? |
| 23 | +Não exatamente: há valor em conhecer os participantes cara a cara. |
| 24 | +Lembre-se de que toda comunicação escrita carece de muita largura de banda em comparação com o encontro presencial: não há gestos, nem mímicas, nem mesmo o tom de voz para ajudar na compreensão. |
| 25 | +Reuniões presenciais são particularmente valiosas para desafios interpessoais, resolvendo conflitos e mal-entendidos. |
| 26 | +No entanto, a comunicação sobre as decisões do projeto deve ser mantida por escrito, para que outros possam acompanhar e influenciar o projeto, e até anos mais tarde é possível rastrear por que uma determinada decisão foi tomada. |
| 27 | +Aqui está a minha regra geral: sinta-se à vontade para tomar café. |
| 28 | +Geralmente isso ajuda a construir uma equipe mais forte, especialmente quando a equipe é dividida em vários locais físicos. |
| 29 | +Certifique-se de que todas as decisões sejam tomadas de uma maneira transparente e assíncrona para que todos-incluindo aqueles https://en.wikipedia.org/wiki/Lurker[lurking] em sua conversa-possam entrar e se tornar contribuidores ativos. |
| 30 | +Um exemplo de quão longe se pode tomar decisões abertas é explicado em vários exercícios no https://opensource.com/open-organization/resources/workbook [Open Organization Workbook]. |
| 31 | +Agora, como você descobre onde um projeto InnerSource gostaria de discutir as mudanças e a direção futura do projeto? |
| 32 | +Muitos projetos InnerSource descrevem como eles gostam de ser abordados por potenciais Contribuidores em seus README.md. Se esse documento se tornar muito grande para lidar, as diretrizes de contribuição tendem a ser divididas em um arquivo chamado arquivos CONTRIBUTING.md. |
| 33 | +Seguir essas recomendações ajuda muito os Colaboradores a venderem a sua oferta. |
| 34 | +Em todas essas interações, esteja preparado para "vender" sua contribuição para a equipe anfitriã. |
| 35 | +Articular o valor que a contribuição trará ao seu ecossistema. |
| 36 | +A equipe de host será a que assumirá a manutenção para suas mudanças |
| 37 | +Faz sentido oferecer para cumprir uma garantia https://patterns.innersourcecommons.org/p/30-day-warranty[30-day] em seu envio. |
| 38 | +Isso pode aliviar o medo da equipe anfitriã de que os Contribuidores não estejam disponíveis para suporte com a correção de erros após o tempo de contribuição.. |
| 39 | +== = Antecipar e seguir as regras da casa |
| 40 | +Quando você estiver visitando seus vizinhos, eles provavelmente ajudarão você em seu apartamento: eles mostrarão o caminho para sua sala de estar e onde o banheiro está localizado. |
| 41 | +Se você ficar mais tempo, eles provavelmente lhe darão mais detalhes: no meu caso, um exemplo seria evitar ligar a máquina de lavar louça e a chaleira elétrica ao mesmo tempo para evitar explodir o fusível. |
| 42 | +Da mesma forma, cada sistema de software vem com suas próprias peculiaridades e complexidades. |
| 43 | +Muitas vezes os mais óbvios são bem documentados. |
| 44 | +Em projetos menores, essa documentação pode ser encontrada no README.md. Em projetos maiores, a documentação específica de contribuição pode ser encontrada no documento CONTRIBUTING.md. |
| 45 | +Nesses arquivos, é possível encontrar informações sobre como efetuar check-out e construir o projeto, como executar o suíte de testes e como enviar mudanças para o projeto. |
| 46 | +Ele pode apontar para a documentação adicional se ela se desviar em grande parte do conjunto de ferramentas padrão-ou se houver coisas que você deve ter em mente ao fazer mudanças. |
| 47 | +Passar por essa documentação geralmente acaba por ser uma grande economia de tempo, pois impede que você siga o caminho errado e avisa sobre os becos sem saída. |
| 48 | +Se você achar que as coisas estão faltando com base em sua experiência-correções para essa documentação são geralmente muito bem-vindas: não há ninguém mais adequado para melhorá-lo do que um novo colaborador que vê o projeto pela primeira vez. |
| 49 | +Tente descobrir junto com o projeto em seu canal de comunicação preferido se as mudanças que você tem em mente fazem sentido em geral. |
| 50 | +No início pode ser assustador ter essas conversas em um meio público da empresa que é arquivado e pesquisável. |
| 51 | +O benefício aqui é com outros que vêm atrás de você com propostas semelhantes: em vez de percorrer exatamente o mesmo caminho novamente, eles podem aprender o que já foi discutido e começar a partir daí. |
| 52 | +Entenda que eles não são os donos da casa e aja de acordo. |
| 53 | +Ser um Contribuidor essencialmente significa estar mais perto da equipe anfitriã do que alguém simplesmente solicitando um recurso. |
| 54 | +Ainda assim, os colaboradores não são responsáveis pelo projeto de software para o qual estão contribuindo. |
| 55 | +Como resultado, a chamada final sobre como a contribuição deve ser é com a equipe anfitriã. |
| 56 | +Ele ajuda a abordar a equipe anfitriã com uma mentalidade humilde, com o pressuposto de que todos estão colaborando para o propósito da organização compartilhada. |
| 57 | +Ajuda a ser aberto e transparente-não apenas sobre o que foi implementado e como, mas também por que a mudança era necessária. |
| 58 | +Trate qualquer feedback como um presente: os outros estão tentando melhorar sua solução, salvando você de problemas mais adiante. |
| 59 | +Há uma chance de que a equipe anfitriã não aceite sua contribuição. |
| 60 | +Nesse caso, ajuda a trabalhar com a equipe, descobrir se há um sub-aspecto de sua necessidade que pode ser resolvido em seu projeto. |
| 61 | +Colabore nesse sub-aspecto e, em seguida, encontre outra maneira de resolver os problemas restantes no seu final. |
| 62 | +## Resumo deste segmento |
| 63 | +Neste segmento, aprendemos como abordar melhor um projeto InnerSource como um Contribuidor. Também analisamos como comunicar melhor nossa necessidade para a mudança e trabalhar na solução em conjunto com a equipe anfitriã. |
0 commit comments