Skip to content

Latest commit

 

History

History
76 lines (41 loc) · 5.54 KB

CONTRIBUTING.md

File metadata and controls

76 lines (41 loc) · 5.54 KB
Raw

Contribuindo:

Ao contribuir com este repositório, primeiro discuta a alteração que deseja fazer via issue, e-mail ou qualquer outro método com os proprietários deste repositório antes de fazer uma alteração.

Observe que temos um código de conduta; siga-o em todas as suas interações com o projeto.

Processo de Pull Request:

  • Verifique as issues existentes no repositório;

  • Faça um fork deste repositório. Ao fazer um fork, é como se fosse criada uma cópia do código-fonte na sua conta, a qual você poderá modificar sem afetar o repositório original;

  • Clone a cópia do repositório para seu ambiente local. Abra a pasta que contém o arquivo que deseja resolver. Exemplo: a primeira questão da lista01 estará no seguinte caminho: Pydawan/lista01_pt-BR/l1q01.py. Não exclua as linhas de comentário com a questão, pois outras pessoas podem querer saber o que você resolveu. Comentários também são importantes, por isso, tente comente seu código sempre que possível para que outros possam aprender com isso;

  • Uma vez solucionada a questão, compile para testá-la antes de solicitar uma pull-request. Feito isso, sincronize seu repositório com o original e só depois realize um commit para seu repositório;

  • Posteriomente, solicite uma PR para o repositório https://github.com/matheusvictor/Pydawan/ com o título resolve #numeroDaIssue. Exemplo: resolve #1;

P.s.: as questões precisam ser resolvidas utilizando funcionalidades compatíveis com a versão do Python 3.7.4 ou inferior.

Adicionando novas questões a serem resolvidas:

Se vocẽ deseja adicionar novas questões para que outras pessoas possam resolver, siga os seguintes passos:

  • Em seu repositório local, escolha uma das pastas de lista e crie o arquivo para a questão;

  • O nível da questão deve está de acordo com o nível , de preferência. Assim, questões mais simples devem ficar na lista01 e assim sucessivamente. A complexidade da questão pode ser levada em conta a partir de alguns fatores como: número de variáveis utilizadas, quantidade de processamentos a serem feitos até chegar ao resultado final, etc.

    • Se considerar a complexidade para além dos diretórios atuais, crie um diretório especial para abrigar esta questão. Ou seja, se a questão for para além da lista04_pt-BR, considere a criação de uma pasta lista05_pt-BR, a qual abrigará a questão sugerida, com numeração consecutiva à última. Ou seja, se a última questão for algo como l5q10.py, você deverá criar l5q11.py.

  • Nomeie o arquivo seguindo o seguinte o padrão adotado em arquivos-questões já existentes. Exemplo: l1q99.py;

  • Feito isso, abra um PR com o commit cria questão l1q99.py.

Corrigindo questões resolvidas:

Caso note algum erro em alguma das questões, ou acredita que pode melhorar o enunciado e/ou a solução existente (se houver), siga os seguintes passos:

  • Corrija o enunciado e/ou a resolução da questão e abra uma PR com o commit corrige questão l1q05.py, por exemplo;

  • Ou, se preferir, abra uma issue com o título Corrigir questão lNqXX.py, para identificar qual questão deve ser corrigida. Por exemplo: Corrigir questão l1q05.py. Na descrição da issue, descreva detalhe o problema o quanto for possível.

Traduções:

Você também pode contribir com este repositório traduzindo as questões para outros idiomas, de preferência para seu idioma nativo ou algum outro que você seja fluente. Se por acaso não houve uma lista de exercícios com o idioma que procura, crie seguindo o mesmo padrão das existentes ou abra uma issue!

Este tópico ainda está em desenvolvimento!

Abrindo novas issues:

Se você notou algo de errado em alguma das soluções, enunciado ou tradução, poderá reportá-lo a partir de uma nova issue. Mas, antes de fazê-lo, verifique com cuidado se alguma outra pessoa já não relatou este problema, assim evita a existência de issues duplicadas.

Este tópico ainda será desenvolvido!

Indicando novos materiais de apoio:

Você também pode ajudar indicando materiais de apoio (gratuitos, preferencialmente).

Este tópico ainda está em desenvolvimento!

Materiais auxiliares:

Editores de texto & IDEs:

Os materiais abaixo podem te ajudar a escrever e/ou compilar seu(s) código(s) Python:

Comandos Git:

Se você também está iniciando com Git, segue abaixo uma pequena lista de materiais que podem te ajudar: