Etiketler, projeler ve kilometre taşları yol haritası

.NET belgeleri ekibi, çalışmalarımızı düzenlemek için GitHub etiketlerini kapsamlı bir şekilde kullanır. Etiket bileşimlerini filtreleyerek .NET docs web sitesindeki ilgi çekici bölümlere hızla odaklanabiliriz. Örneğin, is:issue is:open label:"dotnet-architecture/svc" sorgusunu kullanarak mimari kılavuzlarındaki tüm açık sorunları filtreleyebiliriz.

GitHub projelerini sprint'leri ve diğer hedef odaklı epic'leri düzenlemek için kullanırız. Ayrıca işi izlemek için GitHub kilometre taşlarını da kullanırız. Planlama için projeleri (sorunlar) ve iş kilometre taşlarını (çekme istekleri) düşünmek en iyisidir.

Bu yol haritasında bu kuruluş araçlarını nasıl kullandığımız açıklanır ve ilgilendiğiniz alanları bulmak için kullandığımız kullanışlı filtrelere bağlantılar bulunur.

Etiketler

Dotnet/docs'a katkıda bulunan ilk deneyiminiz buysa, yardım istenen sorunlarla başlayın. Bunlar, daha odaklanmış bir kapsama sahip olan sorunlardır. İlk katkınızı yapmak için harika bir yoldur. Yakalamalar görünümünden, sorunları alanlara ve önceliğe göre daha fazla filtreleyebilirsiniz. Yeni başlayanlar için ilk iyi sorun etiketiyle, ilk katkınızı daha küçük bir şekilde denemek istiyorsanız iyi başlangıç sorunları belirledik.

Sorunları birçok farklı şekilde sınıflandırmak için etiketleri kullanırız:

• .NET Kılavuzları ve kılavuzun bölümleri.
• Hedef sürüm

Üzerinde çalışmak istediğiniz sorunları bulmak için dar bir odak oluşturmak için her kümedeki bir etiketi (kılavuz, yayın, öncelik) birleştirebilirsiniz.

Tek bir .NET kılavuzuyla ilgili sorunları bulma

Mimari e-kitaplarının her biri ve her .NET Kılavuzu için etiketler kullanırız. Tüm e-kitaplarda dotnet-architecture/prod etiketi gösterilir. Her kitabın ile /subsvcbiten benzersiz bir etiketi vardır.

Her bir .NET Kılavuzu, sonek olarak /svc ile not edilir ve mavi ve gri arka plana sahiptir. .NET kılavuzlarının her biri için filtrelenen güncel sorunlar aşağıdadır.

• .NET Kılavuzu - dotnet/svc
• .NET Temel Bilgiler Kılavuzu (eski adıyla .NET Standart Kılavuzu) - dotnet-fundamentals/svc
• .NET Temel Bilgiler Kılavuzu (eski adıyla .NET Core Kılavuzu) - dotnet-core/svc
• .NET Framework Kılavuzu - dotnet-framework/svc
• API Başvurusu - dotnet-api/svc
• C# Kılavuzu - dotnet-csharp/svc
• F# Kılavuzu- dotnet-fsharp/svc
• Visual Basic Kılavuzu -
• ML.NET Kılavuzu - dotnet-ml/svc
• Azure .NET SDK ' sı - dotnet-azure/svc
• .NET Masaüstü Kılavuzu - dotnet-desktop/svc

Diğer ürün etiketleri depolar arası alanlar için tanımlanır.

Kılavuzun bir bölümüyle ilgili sorunları bulma

.NET kılavuzları büyük olduğundan, bu etiketler kapsamı kılavuzun bir bölümüyle daha da sınırlandırıyor. Her bir .NET Kılavuzu alt alanı /subsvc soneki ile not edilir ve açık mavi arka plana sahiptir. Bu etiketlerin çoğu birden çok kılavuza uygulanırken, diğerleri tek bir kılavuzda yer alır. Bir alanı filtreledikten sonra, sorunların kapsamını daha da sınırlamak için bu etiketlerden birini ekleyin.

Yayınlar

Belirli bir sürüm için etiketlenen sorunlar ön ek ile :checkered_flag: Release: not edilir ve koyu sarı arka plana sahiptir.

Diğer etiketler ne olacak?

İçerik ekipleri tarafından farklı sorun sınıflandırmalarını yönetmek için kullanılan birçok etiket daha vardır. İçerik ekibinde değilseniz, diğer etiketleri yoksayabilirsiniz.

Projeler

Projeler, öncelikli çalışmaların Kanban panosu aracılığıyla otomatikleştirildiği planlama amaçlarına yöneliktir. Projeler yalnızca GitHub problemlerini içermeli, çekme isteklerini içermemelidir. Projeler kilometre taşlarından farklıdır, çünkü kilometre taşlarında genellikle çekme istekleri bulunur. Pull isteklerinin bayatlamadığından emin olmak için kilometre taşlarını izliyoruz.

Projeleri iki şekilde kullanırız:

• Month YYYY proje türleri: Bunlar her ayın çalışma planı için Kanban panolarıdır.
• Uzun süre çalışan epikler: Bunlar, işin birkaç aya yayıldığı bir hedefe yönelik görevleri düzenlemek için kullanılır.

Dönüm noktaları

Kilometre taşları genellikle projelerin Month YYYYadlandırma kuralına uyar, ancak projelerden farklıdır. Tamamlanan çalışmayı izlemek için kilometre taşlarını kullanırız. Dönüm noktaları sorunları (olası işler) içermemeli, yalnızca pull isteklerini içermelidir. Geçerli kilometre taşı yeni pull request'lere otomatik olarak uygulanır.