Peta strategi label, proyek, dan tonggak pencapaian

Tim dokumen .NET memanfaatkan label GitHub secara ekstensif untuk mengatur pekerjaan kami. Dengan memfilter kombinasi label, kita dapat dengan cepat fokus pada bagian yang menarik di situs web dokumen .NET. Misalnya, kita dapat memfilter semua masalah terbuka pada panduan arsitektur dengan kueri ke adalah:issue is:open label:"dotnet-architecture/prod".

Kami menggunakan proyek GitHub untuk mengatur sprint dan epik berorientasi tujuan lainnya. Kami juga menggunakan pencapaian GitHub untuk melacak pekerjaan. Yang terbaik adalah memikirkan proyek untuk perencanaan (masalah), dan tonggak untuk pekerjaan (permintaan pull).

Peta strategi ini menjelaskan bagaimana kami menggunakan alat organisasi ini dan memiliki tautan ke filter berguna yang kami gunakan untuk menemukan area yang menarik.

Label

Jika ini adalah pengalaman pertama Anda berkontribusi pada dotnet/docs, mulailah dengan masalah up-for-grabs . Ini adalah masalah yang memiliki cakupan yang lebih terfokus. Mereka adalah cara yang bagus untuk membuat kontribusi pertama Anda. Dari tampilan up-for-grabs, Anda dapat memfilter masalah lebih lanjut berdasarkan area dan prioritas. Kami telah mengidentifikasi masalah yang baik untuk pemula dengan masalah pertama yang baik jika Anda ingin mencoba kontribusi pertama yang lebih kecil.

Kami menggunakan label untuk mengklasifikasikan masalah dengan berbagai cara:

• Panduan .NET dan bagian panduan.
• Rilis target
• Prioritas

Anda dapat menggabungkan label dari setiap set (panduan, rilis, prioritas) untuk membuat fokus sempit untuk menemukan masalah yang ingin Anda kerjakan.

Menemukan masalah untuk satu panduan .NET

Kami menggunakan label untuk setiap e-book arsitektur dan untuk setiap Panduan .NET. Semua ebook dicatat dengan label dotnet-architecture/prod . Setiap buku memiliki label unik yang diakhir dengan /tech.

Setiap .NET Guide dicatat dengan akhiran /prod dan memiliki latar belakang biru-abu-abu. Berikut adalah masalah saat ini yang difilter untuk setiap panduan .NET.

• Panduan .NET - dotnet/prod
• Panduan Dasar-Dasar .NET (sebelumnya Panduan Standar .NET) - dotnet-fundamentals/prod
• Panduan Dasar-Dasar .NET (sebelumnya .NET Core Guide) - dotnet-core/prod
• Panduan .NET Framework -dotnet-framework/prod
• Referensi API - dotnet-api/prod
• Panduan C# - dotnet-csharp/prod
• Panduan F# - dotnet-fsharp/prod
• Panduan Visual Basic - 'dotnet-visualbasic/prod
• Panduan ML.NET - dotnet-ml/prod
• Azure .NET SDK - azure-dotnet/prod
• .NET untuk Panduan Apache Spark - dotnet-spark/prod
• Panduan Desktop .NET - dotnet-desktop/prod

Label produk lainnya didefinisikan untuk area yang lintas repositori.

Menemukan masalah untuk satu bagian panduan

Panduan .NET berukuran besar, sehingga label ini membatasi cakupan lebih lanjut dengan bagian panduan. Setiap subarea .NET Guide dicatat dengan akhiran /tech dan memiliki latar belakang biru muda. Banyak dari label ini berlaku untuk beberapa panduan, sementara yang lain hanya dalam satu panduan. Setelah memfilter area, tambahkan salah satu label ini untuk membatasi cakupan masalah lebih lanjut.

Rilis

Masalah yang ditandai untuk rilis tertentu dicatat dengan awalan :checkered_flag: Release: dan memiliki latar belakang kuning gelap.

Prioritas

Label prioritas semuanya Pri diikuti oleh satu digit. Angka yang lebih rendah adalah prioritas yang lebih tinggi:

• Pri0 - Prioritas kritis

  Masalah keamanan atau diperlukan secara hukum untuk kepatuhan. Kami menjatuhkan segala sesuatu yang lain untuk memperbaiki.

• Pri1 - Prioritas tinggi

  Penting untuk skenario umum. Atau kesalahan yang sangat terlihat pada artikel tampilan halaman tinggi. Kami melakukan ini sebelum P2 atau P3 berfungsi.

• Pri2 - Prioritas sedang

  Berguna untuk skenario umum tetapi tidak memblokir. Kami melakukan ini jika cepat dan mudah, atau sesuai dengan mereka saat mengatasi masalah P1 di artikel yang sama.

• Pri3 - Prioritas rendah

  Berguna untuk kasus tepi, koreksi sepele untuk skenario umum, artikel tampilan halaman rendah, atau teknologi yang tidak digunakan lagi. Tidak sebanding dengan waktu kami tetapi siap untuk meraih kontribusi komunitas. Masalah P3 dapat ditutup jika tidak diatasi setelah dua bulan.

Bagaimana dengan label lainnya

Ada banyak label lain yang digunakan oleh tim konten untuk mengelola klasifikasi masalah yang berbeda. Jika Anda tidak berada di tim konten, Anda dapat mengabaikan label lain ini.

Proyek

Proyek ditujukan untuk tujuan perencanaan, di mana pekerjaan yang diprioritaskan diotomatisasi melalui papan Kanban. Proyek hanya boleh berisi masalah GitHub, bukan permintaan pull. Proyek berbeda dari tonggak pencapaian, dalam tonggak itu hanya berisi permintaan pull.

Kami menggunakan proyek dengan dua cara:

• Month YYYY jenis proyek: Ini adalah papan Kanban untuk rencana kerja setiap bulan.
  • Contohnya, Juli 2020, Agustus 2020, dan sebagainya.
• Epik jangka panjang: Ini digunakan untuk mengatur tugas menuju tujuan ketika pekerjaan akan terjadi selama beberapa bulan.
  • Contoh: .NET 5 Wave - Reorganization, .NET Languages (.NET 5 wave) , dan sebagainya.

Pencapaian

Milestones biasanya mengikuti konvensi penamaan proyek Month YYYYyang sama, tetapi berbeda dari proyek. Kami menggunakan pencapaian untuk melacak pekerjaan yang selesai. Pencapaian tidak boleh berisi masalah (potensi pekerjaan), tetapi secara eksklusif berisi permintaan pull. Tonggak pencapaian saat ini secara otomatis diterapkan ke permintaan pull baru.