Código de conduta em um projeto de código aberto

É o documento que diz como as pessoas devem se tratar nos espaços do projeto: issues, pull requests, chats e eventos. A Open Source Guides explica o motivo em três pontos: ele estabelece o que se espera dos participantes, protege participantes e mantenedores de atitudes que desgastam a comunidade ao longo do tempo e dá a quem mantém um fundamento para agir quando alguém passa do limite. Para quem chega e é novo, ver um código de conduta é um sinal de que o projeto pensou em acolher.

Segundo a Open Source Guides, um código de conduta precisa responder cinco perguntas:

• Onde vale? Só nas issues e pull requests, ou também em eventos e outros canais?
• A quem vale? Membros da comunidade, mantenedores e, se for o caso, patrocinadores?
• O que acontece com quem o descumpre?
• Como relatar uma violação? Com um canal privado e, se o relato for sobre a pessoa que recebe os relatos, um caminho alternativo.
• Quem aplica, e como?

O guia insiste num ponto: um código de conduta que não é aplicado, ou que não pode ser, é pior que nenhum. Por isso, só adote um que você esteja disposto a fazer valer.

O modelo mais conhecido é o Contributor Covenant. A Open Source Guides o descreve como uma opção pronta, usada por mais de 40.000 projetos. A versão mais recente listada no site é a 3.0, que traz as seções Our Pledge, Encouraged Behaviors, Restricted Behaviors, Reporting an Issue, Addressing and Repairing Harm, Scope e Attribution. A escada de medidas vai de aviso (Warning) a banimento permanente (Permanent Ban), passando por atividades temporariamente limitadas e suspensão temporária. A versão 2.1 continua publicada.

Dois cuidados:

1. O modelo tem campos a preencher, como o método de contato para relatos. Antes de publicar, preencha tudo o que estiver entre colchetes; um código sem canal de relato não funciona.
2. A página da versão 3.0 declara a licença CC BY-SA 4.0, que exige crédito e que adaptações usem a mesma licença. Por isso, este site não reproduz o texto do Contributor Covenant: aponta para o gerador oficial do projeto, o /adopt do contributor-covenant.org, em que você escolhe o idioma, informa como relatar e baixa o documento. Se existe tradução em português do Brasil, a página de traduções do site diz: não confirmamos nesta leitura.

A documentação do GitHub diz que o arquivo CODE_OF_CONDUCT.md pode ficar em .github, na raiz ou em docs; o GitHub usa o primeiro que achar, nessa ordem. Há modelos no botão "Choose a code of conduct template" do próprio GitHub, mas a página não diz quais são. A Open Source Guides recomenda a raiz e um link a partir do README ou do CONTRIBUTING. O perfil da comunidade do repositório marca "Code of conduct" como adicionado quando o arquivo existe e não está vazio.

1. Ana mantém o projeto listaki e quer adotar um código de conduta.
2. Ela decide quem recebe os relatos (ela e um segundo mantenedor, para haver um caminho se o relato for sobre um deles) e cria um e-mail só para isso.
3. Gera o documento no /adopt do Contributor Covenant, informando esse e-mail como método de contato, e baixa o arquivo.
4. Salva como CODE_OF_CONDUCT.md na raiz do repositório e faz o commit.
5. No README e no CONTRIBUTING, acrescenta uma linha com o link. O gerador de README e o gerador de CONTRIBUTING já têm a caixa para marcar.
6. Combina com o outro mantenedor o que cada um fará ao receber um relato. Sem isso, o documento não passa de enfeite.