Modalità di gestione dei problemi

Questo articolo illustra come gestire i problemi nel repository PowerShell-Docs. Questo articolo è progettato per essere un aiuto di lavoro per i membri del team PowerShell-Docs. Queste informazioni vengono pubblicate qui per garantire la trasparenza dei processi per i collaboratori pubblici.

Origini dei problemi

• Collaboratori della comunità
• Collaboratori interni
• Trascrizioni di commenti da canali di social media
• Commenti e suggerimenti tramite il modulo di feedback di Docs

Obiettivi del tempo di risposta

80% dei nuovi problemi vengono chiusi entro 3 giorni lavorativi.

• Triaged - 1 giorno lavorativo
• Correzione o modifica - 10 giorni lavorativi

Etichettatura e traguardi

Tipi di etichetta

• Area: identifica la parte di PowerShell o dei documenti di cui il problema discute
• Problema - Tipo di problema: ad esempio bug, feedback o idea
• Priorità - Priorità del problema; intervallo di valori 0-3 (alto-basso)
• Qualità - lo sforzo per migliorare la qualità a cui il problema si impegna a risolvere.
• Stato : stato dell'elemento di lavoro o motivo per cui è stato chiuso
• Tag - usato per una classificazione aggiuntiva, come la disponibilità o eventi di documentazione intensiva
• In attesa : indica che stiamo aspettando una persona o un evento esterno

Per altre informazioni su etichette specifiche, vedere Etichettatura.

Passaggi fondamentali

I problemi e le pull request devono essere contrassegnati con il milestone appropriato. Se il problema non si applica a una versione specifica, non viene utilizzato alcun traguardo. Le richieste pull e i problemi correlati per le modifiche che devono ancora essere unite nella codebase di PowerShell devono essere assegnati al traguardo Future. Dopo aver unito la modifica, aggiornare il traguardo alla versione appropriata.

Passaggio fondamentale	Descrizione
7.0.0	Elementi di lavoro correlati a PowerShell 7.0
7.2.0	Elementi di lavoro correlati a PowerShell 7.2
7.3.0	Elementi di lavoro correlati a PowerShell 7.3
In futuro	Elementi di lavoro per una versione futura di PowerShell

Processo di triage

I membri del team della documentazione di PowerShell esaminano i problemi ogni giorno e valutano i nuovi problemi man mano che arrivano. Il team incontra ogni settimana per discutere i problemi difficili che richiedono la valutazione e la definizione delle priorità del lavoro.

Commenti sul prodotto fuori posto

• Immettere un commento che reindirizza il cliente al canale di feedback corretto.

• Facoltativo: copiare il problema nel percorso di feedback del prodotto appropriato, aggiungere un collegamento all'elemento copiato e chiudere il problema.

  Il percorso predefinito per i problemi di PowerShell è https://github.com/PowerShell/PowerShell/issues/new/choose.

Richieste di supporto

• Se la domanda di supporto è semplice, rispondere educatamente e chiudere il problema.

• Se la domanda è più complessa o il mittente risponde con altre domande, reindirizzarli ai forum e ai canali di supporto. Testo suggerito per il reindirizzamento ai forum:

  > 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
  

Codice di violazioni di comportamento

• Modificare il problema per rimuovere qualsiasi contenuto offensivo, se necessario
• Inserire un commento che indica che la segnalazione è spam, chiudere la segnalazione e quindi bloccarla per impedire ulteriori commenti
• Discutere ogni violazione nella riunione di valutazione regolare per determinare la necessità di ulteriori azioni