Roadmap per etichette, progetti e attività cardine

Per organizzare il lavoro, il team della documentazione di .NET fa ampio uso delle etichette GitHub. L'applicazione di un filtro basato su una combinazione di etichette consente di concentrare l'attenzione sulle sezioni di interesse del sito Web Documentazione di .NET. Ad esempio, è possibile filtrare tutti i problemi aperti nelle guide all'architettura con una query a is:issue is:open label:"dotnet-architecture/prod".

Vengono usati progetti GitHub per organizzare sprint e altre epiche orientate agli obiettivi. Per tenere traccia del lavoro vengono usate attività cardine di GitHub. È consigliabile usare i progetti per la pianificazione (problemi) e le attività cardine per il lavoro (richieste pull).

Questa roadmap illustra come vengono usati questi strumenti organizzativi e include collegamenti a filtri che consentono di individuare aree di interesse in modo pratico e veloce.

Etichette

Se questa è la prima esperienza di collaborazione con dotnet/docs, iniziare con i problemi up-for-grabs. Questi problemi, dato l'ambito più mirato, sono ideali per un primo contributo. Dalla visualizzazione up-for-grabs è possibile filtrare ulteriormente i problemi in base alle aree e alla priorità. Per chi vuole cimentarsi per la prima volta offrendo un contributo di portata minore, è disponibile un certo numero di problemi adatti ai principianti, contrassegnati dall'etichetta good-first-issue.

È possibile usare etichette per classificare i problemi in molti modi diversi:

• Guide di .NET e sezioni di una guida.
• Versione di destinazione
• Priorità

È possibile combinare un'etichetta di ogni set (guida, versione, priorità) per ridurre l'ambito di ricerca e individuare i problemi di cui occuparsi.

Trovare problemi per una singola guida .NET

Vengono usate etichette per ogni e-book di architettura e per ogni guida di .NET. Tutti gli ebook sono indicati con l'etichetta dotnet-architecture/prod . Ogni libro ha un'etichetta univoca che termina con /tech.

Ogni guida .NET viene annotata con il /prod suffisso e ha uno sfondo blu-grigio. Di seguito sono riportati i problemi correnti filtrati per ogni guida di .NET.

• Guida a .NET - dotnet/prod
• Guida ai concetti fondamentali di .NET (precedentemente guida a .NET Standard) - dotnet-fundamentals/prod
• Guida ai concetti fondamentali di .NET (in precedenza guida a .NET Core) - dotnet-core/prod
• Guida a .NET Framework - dotnet-framework/prod
• Informazioni di riferimento sulle API - dotnet-api/prod
• Guida per C# - dotnet-csharp/prod
• Guida A F# dotnet-fsharp/prod
• Guida di Visual Basic - 'dotnet-visualbasic/prod
• Guida ML.NET - dotnet-ml/prod
• Azure .NET SDK - azure-dotnet/prod
• Guida a .NET per Apache Spark - dotnet-spark/prod
• Guida di .NET Desktop - dotnet-desktop/prod

Altre etichette di prodotto sono definite per le aree che intersecano i repository.

Trovare i problemi per una sezione di una guida

Le guide relative a .NET sono di grandi dimensioni, pertanto queste etichette limitano ulteriormente l'ambito a una sezione di una guida. Ogni sottoarea della Guida .NET viene annotata con il /tech suffisso e ha uno sfondo blu chiaro. Molte di queste etichette si applicano a più guide, mentre altre si trovano in una sola guida. Dopo aver filtrato in base a un'area, aggiungere una di queste etichette per limitare ulteriormente l'ambito dei problemi.

Versioni

I problemi contrassegnati per una versione specifica sono indicati con il prefisso :checkered_flag: Release: e hanno uno sfondo giallo scuro.

Priorità

Le etichette di priorità sono tutte contrassegnate da Pri seguita da una sola cifra. I numeri più bassi indicano una priorità più alta:

• Pri0 - Priorità critica

  Problema di sicurezza o richiesta legale per ragioni di conformità. Vengono ignorati tutti gli altri problemi da risolvere.

• Pri1 - Alta priorità

  Essenziale per gli scenari comuni. Oppure errore a visibilità elevata in un articolo della visualizzazione pagina con traffico elevato. Questo problema viene affrontato prima delle attività con priorità P2 o P3.

• Pri2 - Priorità media

  Utile per gli scenari comuni ma non comporta alcun blocco. Queste attività vengono eseguiti se rapide e semplici o vengono inserite mentre si risolve un problema P1 nello stesso articolo.

• Pri3 - Priorità bassa

  Utile per casi secondari, correzioni semplici per scenari comuni, articoli della visualizzazione pagina con traffico scarso o tecnologie deprecate. Non importante ma utile per i contributi della community. Un problema P3 può essere chiuso se non viene risolto dopo due mesi.

Significato delle altre etichette

I team dei contenuti possono usare molte altre etichette per gestire le diverse classificazioni dei problemi. Se non si fa parte di un team di contenuto, è possibile ignorare le altre etichette.

Progetti

I progetti sono destinati a scopi di pianificazione, in cui il lavoro classificato in ordine di priorità viene automatizzato tramite una lavagna Kanban. I progetti devono contenere solo problemi di GitHub, non richieste pull. I progetti sono diversi dalle attività cardine, poiché queste ultime contengono solo richieste pull.

I progetti vengono usati in due modi:

• Tipi di progetto Month YYYY: si tratta di lavagne Kanban per il piano di lavoro di ogni mese.
  • Esempi: luglio 2020, agosto 2020 e così via.
• Epiche a esecuzione prolungata: Usate per organizzare le attività finalizzate a un obiettivo quando il lavoro richiederà diversi mesi.
  • Esempi: .NET 5 Wave - Reorganization, .NET Languages (.NET 5 wave) e così via.

Attività cardine

In genere le attività cardine seguono la stessa convenzione di denominazione dei progetti Month YYYY, ma sono diverse dai progetti. Le attività cardine vengono usate per tenere traccia del lavoro completato. Le attività cardine non devono contenere problemi (lavoro potenziale), ma esclusivamente richieste pull. L'attività cardine corrente viene applicata automaticamente alle nuove richieste pull.