How we manage issues (Como gerimos os problemas)

Este artigo documenta como gerenciamos problemas no repositório PowerShell-Docs. Este artigo foi concebido para ser uma ajuda de emprego para os membros da equipa PowerShell-Docs. Publicamos essas informações aqui para fornecer transparência ao processo para nossos colaboradores públicos.

Fontes dos problemas

• Contribuidores comunitários
• Colaboradores internos
• Transcrições de comentários de canais de mídia social
• Comentários através do formulário de feedback do Google Docs.

Metas de tempo de resposta

80% de novas questões são encerradas no prazo de 3 dias úteis.

• Triagem - 1 dia útil
• Corrigir ou alterar - 10 dias úteis

Etiquetagem e etapas

Tipos de rótulo

• Área - Identifica a parte do PowerShell ou da documentação em que o problema está a ser discutido
• Problema - O tipo de problema: como bug, feedback ou ideia
• Prioridade - A prioridade da questão; intervalo de valores 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
• Tag - Utilizado para classificação adicional, como disponibilidade ou maratonas de documentação (doc-a-thons)
• Aguardando - Mostra que estamos esperando por alguma pessoa ou evento externo

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

Marcos importantes

As questões e as RP devem ser marcadas com o marco adequado. Se o problema não se aplicar a uma versão específica, nenhum marco será usado. PRs e problemas relacionados a alterações que ainda precisam ser mescladas na base de código do PowerShell devem ser atribuídos à etapa Futura . Depois de fundir a alteração, atualize o marco para a versão correcta.

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 à medida que eles chegam. A equipe se reúne semanalmente para discutir questões difíceis, precisam de triagem e priorizar o trabalho.

Feedback de produto em local incorreto

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

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

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

Pedidos de suporte

• Se a pergunta de suporte for simples, responda-a educadamente e feche o problema.

• Se a pergunta for mais complicada ou se o remetente responder com mais perguntas, redirecione-a para fóruns e canais de suporte. Texto sugerido para redirecionar 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

• Edite 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 mais comentários
• Discuta cada violação na reunião regular de triagem para determinar a necessidade de ações adicionais