tarcisiofischer / livrocpp

Esse livro virtual gratuito é uma iniciativa da comunidade C/C++ Brasil que pretende trazer uma fonte moderna, confiável e completa para o estudo de C++.
Creative Commons Zero v1.0 Universal
25 stars 5 forks source link

Adicionar CONTRIBUTING.md #17

Open luizffgv opened 1 year ago

luizffgv commented 1 year ago

Eu sinto que esse repositório sofre com a falta de um CONTRIBUTING.md. Nosso próprio README tem uma seção sobre como contribuir—com orientações válidas—porém um CONTRIBUTING.md é mais adequado pra formalizar o que esperamos de uma issue ou pull request.

Uma coisa que já seria útil adicionar é a linguagem que devemos utilizar. Nossos commits iniciais foram em português e parece ter ocorrido uma mudança pra inglês no processo, mas nada formalizado. Isso atrapalha um pouco quem quer contribuir, ou até mesmo ler o histórico do repositório.

tarcisiofischer commented 1 year ago

Boa. Obrigado pelas sugestões, acho que são todas pertinentes. Posso sim adicionar um CONTRIBUTING.md. Informações que pretendo adicionar (se alguém tiver outras sinta-se livre pra sugerir). Quando vc diz "qual a linguagem que devemos utilizar", queres dizer o "tempo verbal" no livro?

O que achas?

luizffgv commented 1 year ago

@tarcisiofischer Essas ideias são boas. Se possível, seria bom também escolher algum formatador e um linter de Markdown pra todos usarem e deixar mais consistente. Eu pessoalmente uso Prettier pra formatar e Markdownlint pra verificar. Isso dá uma tarefa a mais pra todos que quiserem contribuir, mas talvez valha a pena. Fica a seu critério.

Um CONTRIBUTING.md meu como exemplo.

Também seria bom botar um aviso sobre utilizar apenas fontes confiáveis para contribuir.

Quando vc diz "qual a linguagem que devemos utilizar", queres dizer o "tempo verbal" no livro?

Nesse caso eu quis dizer a linguagem que usamos nas commit messages e PRs. Inglês vs. português.