Jak zarządzamy problemami

W tym artykule opisano sposób zarządzania problemami w repozytorium PowerShell-Docs. Ten artykuł jest przeznaczony do pomocy w pracy dla członków zespołu PowerShell-Docs. Publikujemy te informacje tutaj, aby zapewnić przejrzystość procesu dla naszych publicznych współautorów.

Źródła problemów

• Osoby przyczyniające się do społeczności
• Współautorzy wewnętrzni
• Transkrypcje komentarzy z kanałów mediów społecznościowych
• Opinie za pośrednictwem formularza opinii witryny Docs

Cele czasu odpowiedzi

80% nowych spraw zostaje zamkniętych w ciągu 3 dni roboczych.

• Rozpatrzone — 1 dzień roboczy
• Poprawka lub zmiana — 10 dni roboczych

Etykietowanie i punkty kontrolne

Typy etykiet

• Obszar — identyfikuje część programu PowerShell lub dokumentacji, którą omawia problem
• Problem — typ problemu: taki jak usterka, opinia lub pomysł
• Priorytet — priorytet problemu; zakres wartości 0–3 (wysoki poziom)
• Jakość — wysiłki na rzecz poprawy jakości, do których zobowiązuje się kwestia w celu rozwiązania problemu
• Stan — stan elementu roboczego lub przyczyna jego zamknięcia
• Tag — służy do dodatkowej klasyfikacji, takiej jak dostępność lub maratony dokumentacyjne
• Oczekiwanie — pokazuje, że czekamy na jakąś osobę zewnętrzną lub wydarzenie

Aby uzyskać więcej informacji na temat określonych etykiet, zobacz Etykietowanie.

Kamienie milowe

Problemy i pull requesty powinny być oznaczone odpowiednim kamieniem milowym. Jeśli problem nie ma zastosowania do określonej wersji, nie zostanie użyty żaden punkt kontrolny. Pull requesty i powiązane problemy dotyczące zmian, które nie zostały jeszcze scalone z bazą kodu programu PowerShell, powinny być przypisane do Przyszłości punktu kontrolnego. Po zintegrowaniu zmiany zaktualizuj kamień milowy do odpowiedniej wersji.

Kamień milowy	Opis
7.0.0	Elementy robocze związane z programem PowerShell 7.0
7.2.0	Elementy robocze związane z programem PowerShell 7.2
7.3.0	Elementy robocze związane z programem PowerShell 7.3
Przyszłość	Zadania robocze dla przyszłej wersji programu PowerShell

Proces segregacji medycznej

Członkowie zespołu dokumentacji programu PowerShell codziennie przeglądają problemy i klasyfikują nowe problemy po ich nadejściu. Zespół spotyka się co tydzień, aby omówić trudne problemy wymagające selekcji oraz ustalenia priorytetów w pracy.

Błędna opinia o produkcie

• Wprowadź komentarz przekierowujący klienta do odpowiedniego kanału opinii.

• Opcjonalnie: Skopiuj problem do odpowiedniej lokalizacji opinii o produkcie, dodaj link do skopiowanego elementu i zamknij problem.

  Domyślną lokalizacją problemów z programem PowerShell jest https://github.com/PowerShell/PowerShell/issues/new/choose.

Żądania pomocy technicznej

• Jeśli pytanie pomocy technicznej jest proste, odpowiedz na nie uprzejmie i zamknij problem.

• Jeśli pytanie jest bardziej skomplikowane lub przesyłająca odpowiada na więcej pytań, przekierowuj je na fora i kanały pomocy technicznej. Sugerowany tekst przekierowania na fora:

  > 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
  

Naruszenia kodeksu postępowania

• Edytuj problem, aby usunąć dowolną obraźliwą zawartość, jeśli jest to konieczne
• Wprowadź komentarz wskazujący, że zgłoszenie to spam, zamknij zgłoszenie, a następnie zablokuj możliwość dalszego komentowania.
• Omów każde naruszenie na regularnym spotkaniu etapowym, aby określić potrzebę dalszych działań.