De manier waarop we problemen beheren

In dit artikel wordt beschreven hoe we problemen in de PowerShell-Docs beheren. Dit artikel is bedoeld als een hulpmiddel voor leden van het PowerShell-Docs team. Deze wordt hier gepubliceerd om transparantie van het proces te bieden voor onze openbare inzenders.

Bronnen van problemen

• Community-inzenders
• Interne inzenders
• Transcripties van opmerkingen van socialemediakanalen
• Feedback via het Docs-feedbackformulier

Doelen voor reactietijd

80% van de nieuwe problemen wordt binnen drie werkdagen gesloten.

• Geseaged - 1 werkdag
• Oplossing of wijziging - 10 werkdagen

Mijlpalen & labelen

Labeltypen

Type	Beschrijving
Gebied	Wordt gebruikt om aan te geven welk deel van PowerShell of de documenten over het probleem worden besproken. Handig voor eigenaren van functies om problemen met hun functie te vinden.
Probleem	Geeft het type probleem aan
Prioriteit	Geeft de prioriteit van het probleem aan. Waardebereik 0 (hoog) -4 (laag)
Status	Geeft de status van het werkitem aan of waarom het is gesloten
Tag	Labels die worden gebruikt voor aanvullende classificatie
Wachten	Geeft aan dat we wachten op iemand of een andere gebeurtenis

Mijlpalen

Problemen en PR's moeten worden getagd met de juiste mijlpaal. Als het probleem niet van toepassing is op een specifieke versie, wordt er geen mijlpaal gebruikt. PR's en gerelateerde problemen met wijzigingen die nog moeten worden samengevoegd in de PowerShell-codebasis, moeten worden toegewezen aan de mijlpaal In de toekomst. Nadat de codewijziging is samengevoegd, wijzigt u de mijlpaal in de juiste versie.

Mijlpaal	Beschrijving
7.0.0	Werkitems met betrekking tot PowerShell 7.0
7.1.0	Werkitems met betrekking tot PowerShell 7.1
7.2.0	Werkitems met betrekking tot PowerShell 7.2
Toekomstig	Werkitems in een toekomstige versie van PowerShell

Triageproces

Teamleden van PowerShell-documenten bekijken de problemen dagelijks en beoordelen nieuwe problemen zodra ze binnenkomen. Het team komt wekelijks samen om problemen te bespreken die moeten worden opgelost of die niet zijn opgelost.

Verkeerd geplaatste productfeedback

• Voer een opmerking in om de klant om te leiden naar het juiste feedbackkanaal.

• Optioneel: kopieer het probleem naar de juiste locatie voor productfeedback, voeg een koppeling toe naar het gekopieerde item en sluit het probleem.

  De standaardlocatie voor PowerShell-problemen is https://github.com/PowerShell/PowerShell/issues/new/choose .

Ondersteuningsaanvragen

• Als de ondersteuningsvraag eenvoudig is, beantwoordt u deze op de juiste manier en sluit u het probleem.

• Als de vraag gecompliceerder is of als de inzender antwoordt met meer vragen, stuurt u deze door naar forums en ondersteuningskanalen. Voorgestelde tekst voor omleiden naar forums:

  > 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://docs.microsoft.com/powershell/scripting/community/community-support
  

Schendingen van de gedragscode

• Bewerk het probleem zo nodig om aanstootgevende inhoud te verwijderen.
• Voer een opmerking in die aangeeft dat het probleem spam is, sluit het probleem en vergrendel het vervolgens om verdere opmerkingen te voorkomen.
• Elke schending moet worden besproken in de wekelijkse triage om te bepalen of er verdere actie moet worden ondernomen (rapporteren aan GitHub of Microsoft Legal).