<commit_before># Guia de boas práticas para revisão de código

Guia de boas práticas para revisão de código. Inspirado, [entre outros](#referencias), no guia da [thoughtbot](https://github.com/thoughtbot/guides/blob/master/code-review/README.md).

## Benefícios

- Antecipação de bugs
- Maior manutenibilidade do código
- Legibilidade do código
- Compartilhamento de conhecimento
  - Tanto em relação à feature que está sendo implementada quanto às técnicas que foram usadas

## Dicas gerais para todos

- Aceite que muitas decisões de programação são opiniões. Discuta as opções, as preferências e cheguem em um consenso rapidamente.
- Questione, não exija. ("O que você pensa sobre chamar esse campo de `user_id`?")
- Se você não entender o que está lendo, pergunte. ("Não entendi, você poderia explicar?").
- Evite palavras que sugiram culpa ou responsabilidade pelo código. ("seu", "meu", "não é meu").
- Não seja grosseiro ou ofensivo.
- Seja explícito e claro. Nem sempre as pessoas entenderão o que você quis dizer.
- Seja descritivo sobre as suas intenções. Descreva as mudanças propostas e faça comentários claros.
- Forneça referências para ajudar a esclarecer as decisões tomadas. ("Acredito que seja melhor alterar a ordem desses _middlewares_ (https://docs.djangoproject.com/en/1.8/topics/http/middleware/#hooks-and-application-order)")
- Seja humilde e sincero. ("Não tenho certeza, vou conferir").
- Não use hipérbole. ("sempre", "nunca", "interminavelmente", "nenhum").
- Não seja sarcástico.
- Não force a barra. Se _emojis_, _gifs_ ou piadinhas não fazem o estilo, não tente forçar. Caso contrário, use-os com bom senso.
- Se a discussão não avançar, converse pessoalmente. Coloque nos _pull requests_ um resumo do que foi conversado e decidido.<commit_msg>Fix link to section "Referências"<commit_after># Guia de boas práticas para revisão de código

Guia de boas práticas para revisão de código. Inspirado, [entre outros](#referências), no guia da [thoughtbot](https://github.com/thoughtbot/guides/blob/master/code-review/README.md).

## Benefícios

- Antecipação de bugs
- Maior manutenibilidade do código
- Legibilidade do código
- Compartilhamento de conhecimento
  - Tanto em relação à feature que está sendo implementada quanto às técnicas que foram usadas

## Dicas gerais para todos

- Aceite que muitas decisões de programação são opiniões. Discuta as opções, as preferências e cheguem em um consenso rapidamente.
- Questione, não exija. ("O que você pensa sobre chamar esse campo de `user_id`?")
- Se você não entender o que está lendo, pergunte. ("Não entendi, você poderia explicar?").
- Evite palavras que sugiram culpa ou responsabilidade pelo código. ("seu", "meu", "não é meu").
- Não seja grosseiro ou ofensivo.
- Seja explícito e claro. Nem sempre as pessoas entenderão o que você quis dizer.
- Seja descritivo sobre as suas intenções. Descreva as mudanças propostas e faça comentários claros.
- Forneça referências para ajudar a esclarecer as decisões tomadas. ("Acredito que seja melhor alterar a ordem desses _middlewares_ (https://docs.djangoproject.com/en/1.8/topics/http/middleware/#hooks-and-application-order)")
- Seja humilde e sincero. ("Não tenho certeza, vou conferir").
- Não use hipérbole. ("sempre", "nunca", "interminavelmente", "nenhum").
- Não seja sarcástico.
- Não force a barra. Se _emojis_, _gifs_ ou piadinhas não fazem o estilo, não tente forçar. Caso contrário, use-os com bom senso.
- Se a discussão não avançar, converse pessoalmente. Coloque nos _pull requests_ um resumo do que foi conversado e decidido.
{'fraction_non_alphanumeric': 0.08179271708683473, 'fraction_numerical': 0.0011204481792717086, 'mean_word_length': 4.468606431852987, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5681717', 'n_tokens_mistral': 1284, 'n_tokens_neox': 1231, 'n_words': 461}