Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Criar arquivo CONTRIBUTING #19

Open
rodrigondec opened this issue Oct 5, 2019 · 5 comments
Open

Criar arquivo CONTRIBUTING #19

rodrigondec opened this issue Oct 5, 2019 · 5 comments
Assignees
Labels
enhancement New feature or request Hacktoberfest

Comments

@rodrigondec
Copy link
Member

rodrigondec commented Oct 5, 2019

Atualmente o contributing está no readme. Deve ser criado o arquivo contributing.

Arquivos de referência de contributing:

Deverá ser explicado:

  • guide de instalação e configuração (já presente no readme)
  • qual o fluxo/etapas para adicionar uma nova funcionalidade no bot (explicado em uma seção abaixo)
  • estilização de código (explicado em uma seção abaixo)
  • fluxo do fork ao PR (já presente no readme) (explicado em uma seção abaixo)
  • mérito de contribuição (explicado em uma seção abaixo)

Fluxo para adicionar nova funcionalidade no bot

Nosso bot utiliza a wrapper lib python-telegram-bot para se comunicar com a API do Telegram
Os passos necessários para extensão de funcionalidade do bot são:

  1. Decidir se será um novo módulo dentro do módulo commands ou se será criado em um já existente
  2. Criar sua função que será chamada no handler
  3. Configurar o handler
    • Caso seja criado um novo módulo, deverá ser criado a função de configurar_handler e importar essa nova função na lista de handlers no arquivo commands/init.py
    • Caso seja criada em um módulo já existente apenas adicionar o command handler utilizando a referência da lib utilizada

estilização do código

copiar a seção estilização de código do integrati-api, só que em portugues

fluxo do fork ao PR

Já tem o fluxo de como se abrir um PR.

Mas deverá ser explicado que:

  • o pr deve ser criado a partir da branch dev e não master
  • estará sujeito ao review dos mantedores do Jerimum, e que podem ser solicitadas mudanças para uma melhor qualidade
  • precisará passar no CI do projeto que realiza os testes e lintagem de código para ser aceito

Mérito de contribuição

Nós temos uma seção dedicada aos contribuidores do projeto no readme

Explicar nessa seção que deverá ser incluso no readme uma contribuição adequada ao contribuidor pelo próprio dono do PR

@rodrigondec rodrigondec changed the title Passar o conteúdo de CONTRIBUTING que está no readme para um arquivo CONTRIBUTING Criar arquivo CONTRIBUTING Oct 5, 2019
@rodrigondec rodrigondec added enhancement New feature or request Hacktoberfest labels Oct 5, 2019
@josehkburger
Copy link

comecei a fazer isso!

@rodrigondec
Copy link
Member Author

rodrigondec commented Oct 6, 2019

@josehkburger incrementei a descrição para ser o mais específico possível do que é esperado.

Percebi que você já abriu o PR posteriormente. Caso não for fazer essas outras alterações solicitadas, darei merge no seu PR e adaptarei esse issue para alterar a partir das sua contribuição 😄

@josehkburger
Copy link

posso fazer sim ,mas estou com pouco tempo agora, pode ser no próximo sábado?

@rodrigondec
Copy link
Member Author

Pode sim. Não tem pressa

@rodrigondec
Copy link
Member Author

@josehkburger feedback?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request Hacktoberfest
Projects
None yet
Development

No branches or pull requests

2 participants