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

.NET belgeleri ekibi, işleri düzenlemek için GitHub etiketlerini kapsamlı olarak kullanır. Etiket birleşimlerini filtreleyerek .NET belgeleri web sitesindeki ilgili bölümlere hızla odaklanabiliriz. Örneğin, mimari kılavuzlarında açık olan tüm sorunları şu sorguyla filtreleyebiliriz : sorun is:open label:"dotnet-architecture/prod".

Sprint’leri ve hedefe yönelik diğer epic’leri düzenlemek için GitHub projelerini kullanırız. Ayrıca çalışmayı izlemek için de GitHub kilometre taşlarını kullanırız. Projeleri planlamaya (sorunlar) ve kilometre taşlarını ise çalışmaya (çekme istekleri) yönelik olarak düşünebilirsiniz.

Bu yol haritası bu kurumsal araçları nasıl kullandığımızı açıklar ve ilgi alanlarını bulmak için kullandığımız faydalı filtrelere açılan bağlantıları içerir.

Etiketler

dotnet/docs’a ilk kez katkıda bulunuyorsanız, herkese açık sorunlarla başlayın. Bu sorunlar, daha odaklanmış bir kapsama sahiptir. Bu, ilk katkınızı yapmak için harika bir yoldur. Sorunları, herkese açık görünümünden bölgelere ve önceliğe göre filtreleyebilirsiniz. İlk olarak küçük bir katkıyı denemek istiyorsanız, ilk sorun için iyi etiketiyle yeni başlayanlar için uygun sorunları belirledik.

Sorunları çeşitli farklı şekillerde sınıflandırmak için etiketleri kullanırız:

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

Üzerinde çalışmak istediğiniz sorunları bulmaya ilişkin sınırlandırılmış bir odak noktası oluşturmak için her kümeden (kılavuz, sürüm, öncelik) bir etiketi birleştirebilirsiniz.

Tek bir .NET kılavuzuyla ilgili sorunları bulma

Her mimari e-kitabı ve her .NET kılavuzu için etiketleri kullanırız. Tüm e-kitaplarda dotnet-architecture/prod etiketi gösterilir. Her kitabın ile /techbiten benzersiz bir etiketi vardır.

Her .NET Kılavuzu soneki ile /prod not edilir ve mavi-gri arka plana sahiptir. .NET’e yönelik kılavuzların her biri için filtrelenmiş mevcut sorunları burada bulabilirsiniz.

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

Diğer ürün etiketleri depolar arasında geçiş yapılan alanlar için tanımlanır.

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

.NET kılavuzları büyük olduğu için bu etiketler kapsamı bir kılavuzun bölümüyle sınırlandırır. Her .NET Kılavuzu alt alanı soneki ile /tech not edilir ve açık mavi arka plana sahiptir. Bu etiketlerin çoğu birden fazla kılavuz için geçerlidir. Ancak bazıları yalnızca bir kılavuzda yer alır. Bir alanı filtreledikten sonra sorunların kapsamını biraz daha daraltmak için bu etiketlerden birini ekleyin.

Yayınlar

Belirli bir sürüm için etiketlenmiş sorunlar :checkered_flag: Release: ön ekiyle belirtilir ve bunların arka planı koyu sarı renkte olur.

Öncelik

Öncelik etiketlerinin tümü Pri özelliği taşır ve bunlardan sonra tek bir sayı gelir. Düşük sayılar yüksek önceliklidir:

• Pri0 - Kritik öncelik

  Güvenlik sorunu veya yasal uyumluluk gereksinimi. Elimizdeki diğer tüm işleri bırakıp buna odaklanırız.

• Pri1 - Yüksek öncelikli

  Yaygın senaryoların önemli olanları. Yüksek sayfa görüntüleme sayısına sahip bir makaleyle ilgili görünürlük düzeyi yüksek bir hata da olabilir. Bunları P2 veya P3 işlerinden önce yaparız.

• Pri2 - Orta öncelikli

  Yaygın ancak çalışmaya engel olmayan senaryolar için kullanılır. Hızlı ve kolay olanları hemen yapar veya aynı makaledeki P1 sorunlarıyla birlikte düzeltiriz.

• Pri3 - Düşük öncelikli

  Çok önemli olmayan olaylar, yaygın senaryolardaki küçük çaplı düzeltmeler, sayfa görüntüleme sayısı düşük olan makaleler veya kullanım dışı bırakılmış teknolojiler için kullanılır. Üzerinde zaman harcamaya değmez ancak topluluk katkısı sağlanması için yönlendirilebilir. İki ay boyunca ilgilenilmeyen P3 sorunları kapatılabilir.

Peki diğer etiketler?

İçerik ekipleri, sorunlara ilişkin farklı sınıflandırmaları yönetmek için birçok farklı etiketi kullanır. İçerik ekibinde yer almıyorsanız diğer etiketleri yoksayabilirsiniz.

Projeler

Projeler, planlama amacıyla tasarlanmıştır ve burada öncelikli çalışmalar bir Kanban panosu aracılığıyla otomatikleştirilir. Projeler, çekme isteklerini değil, yalnızca GitHub sorunlarını içermelidir. Projeler, kilometre taşlarından farklılık gösterir. Kilometre taşları yalnızca çekme isteklerini içerir.

Projeler iki şekilde kullanılır:

• Month YYYY proje türleri: Bunlar, her ayın çalışma planına yönelik Kanban panolarıdır.
  • Örneğin Temmuz 2020, Ağustos 2020 gibi.
• Uzun süre çalışan epicler: Bunlar, çalışmaların birkaç ay süreceği işlerde bir hedefe yönelik görevleri düzenlemek için kullanılır.
  • Örnekler: .NET 5 Wave - Yeniden Düzenleme, .NET Dilleri (.NET 5 wave) gibi.

Kilometre taşları

Kilometre taşları genellikle projelerle aynı adlandırma kuralını (Month YYYY) izler, ancak projelerden farklıdır. Tamamlanan çalışmayı izlemek için kilometre taşlarını kullanırız. Kilometre taşları, sorunları (olası çalışma) değil, yalnızca çekme isteklerini içermelidir. Geçerli kilometre taşı otomatik olarak yeni çekme isteklerine uygulanır.