Como gerenciamos problemas

Este artigo documenta como gerenciamos problemas no repositório PowerShell-Docs. O artigo foi projetado para ser um auxílio de trabalho para membros da equipe do PowerShell-Docs. Publicamos essas informações aqui para fornecer transparência de processo para nossos colaboradores públicos.

Fontes de problemas

• Colaboradores da Comunidade
• Colaboradores internos
• Transcrições de comentários de canais de mídia social
• Comentários por meio do formulário de comentários do Docs

Destinos de tempo de resposta

80% de novos problemas são fechados em três dias úteis.

• Triagem – 1 dia útil
• Correção ou alteração – 10 dias úteis

Rotulagem e Etapas

Tipos de rótulo

• Área – Identifica a parte do PowerShell ou os documentos que o problema está discutindo
• Problema – O tipo de problema: como bug, comentários ou ideia
• Prioridade – a prioridade do problema; intervalo de valor 0-3 (alto-baixo)
• Qualidade – O esforço de melhoria da qualidade que o problema se compromete a resolver
• Status – O status do item de trabalho ou por que ele foi fechado
• Etiqueta – Usada para classificação adicional, como disponibilidade ou maratonas de documentação.
• Aguardando – Mostra que estamos esperando por alguma pessoa ou evento externo

Para obter mais informações sobre rótulos específicos, consulte Rotulagem.

Marcos

Problemas e PRs devem ser marcados com o marco apropriado. Se o problema não se aplicar a uma versão específica, nenhum marco será usado. PRs e problemas relacionados para alterações que ainda não foram mescladas na base de código do PowerShell devem ser atribuídos ao marco futuro . Depois de mesclar a alteração, atualize o marco de referência para a versão correta.

Marco	Descrição
7.0.0	Itens de trabalho relacionados ao PowerShell 7.0
7.2.0	Itens de trabalho relacionados ao PowerShell 7.2
7.3.0	Itens de trabalho relacionados ao PowerShell 7.3
Futuro	Itens de trabalho para uma versão futura do PowerShell

Processo de triagem

Os membros da equipe de documentos do PowerShell revisam os problemas diariamente e fazem a triagem de novos problemas quando chegam. A equipe se reúne semanalmente para discutir questões difíceis que precisam de triagem e priorizar o trabalho.

Comentários sobre produtos perdidos

• Insira um comentário redirecionando o cliente para o canal de comentários correto.

• Opcional: copie o problema para o local de comentários do produto apropriado, adicione um link ao item copiado e feche o problema.

  O local padrão para problemas do PowerShell é https://github.com/PowerShell/PowerShell/issues/new/choose.

Solicitações de suporte

• Se a pergunta de apoio for simples, responda educadamente e feche a questão.

• Se a pergunta for mais complicada ou o remetente responder com mais perguntas, redirecione-as para fóruns e canais de suporte. Texto sugerido para redirecionamento para fóruns:

  > This is not the right forum for these kinds of questions. Try posting your question in a
  > community support forum. For a list of community forums see:
  > https://learn.microsoft.com/powershell/scripting/community/community-support
  

Violações do código de conduta

• Editar o problema para remover qualquer conteúdo ofensivo, se necessário
• Insira um comentário indicando que o problema é spam, feche o problema e bloqueie-o para evitar comentários adicionais
• Discutir cada violação na reunião de triagem regular para determinar a necessidade de mais ações