python / python/devguide

Clarify issue/PR choreography

Aberta
#1,815 8 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
Python
Estrelas
2.1k
Forks
1k
Merge médio
2d 12h
PRs com merge (30d)
12

Descrição

From a discussion with @picnixz:

I think the problem with the devguide is the first sentence is "Create an issue that describes the change" and you'll see the mention to DPO only during creation. We can improve that
I would expect people to read the issue template correctly and understand that something is not trivial
and more importantly: WAIT for triagers to decide whether it's ok or not as an issue
There are obvious cases where the issue doesn't a triager for validation, like a clear bug (and even this is subject to interpretation sometimes) but the process issue+PR is the worst for triagers, especially when the PR is automated.

This might be a duplicate of other feedback here in issues, but I wanted to capture it before going back to $WORK.

Guia de contribuição

Abrir o guia de contribuição

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Comece localizando as instruções iniciais do devguide e o template de issue; em seguida, revise onde as orientações sobre DPO e triagers são introduzidas. Esclareça que os contributors devem aguardar a validação de um triager antes de abrir um PR, observando também a discussão sobre bugs claros. Considera-se concluído quando o fluxo de trabalho de issue-to-PR e as exceções estiverem explícitos para os contributors.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Domínio
documentation
Tipo de issue
Documentação
Dificuldade
3/5
Tempo estimado
1-2 dias
Status de atividade
Ativa
Clareza
Razoavelmente clara
Facilidade para iniciantes
52/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.