Berkontribusi pada MRTK2

Mixed Reality Toolkit (MRTK) menyambut baik kontribusi dari masyarakat. Semua perubahannya kecil atau besar, perlu mematuhi standar pengkodean MRTK, jadi pastikan Anda terbiasa dengan ini saat mengembangkan untuk menghindari keterlambatan ketika perubahan sedang ditinjau.

Jika Anda memiliki pertanyaan, silakan hubungi saluran mixed-reality-toolkit di Slack. Anda dapat bergabung dengan komunitas Slack melalui pengirim undangan otomatis.

Proses pengiriman

Kami menyediakan beberapa jalur untuk memungkinkan pengembang berkontribusi pada Mixed Reality Toolkit, semuanya dimulai dengan membuat Masalah baru.

Pilih Jenis Masalah

Dari sini Anda mengajukan:

  • Laporan bug - Masalah fungsionalitas dengan salah satu komponen toolkit Mixed Reality
  • Masalah dokumentasi - Masalah dengan dokumentasi toolkit Mixed Reality
  • Permintaan fitur - Proposal untuk fitur toolkit Mixed Reality baru

Mengajukan permintaan fitur

Saat meminta fitur toolkit Mixed Reality baru, penting untuk mendokumen manfaat/masalah pelanggan yang akan diselesaikan. Setelah dikirimkan, permintaan fitur akan ditinjau dan dibahas di GitHub. Kami mendorong diskusi terbuka dan konstruktif dari setiap proposal fitur untuk memastikan bahwa pekerjaan tersebut bermanfaat bagi segmen pelanggan yang besar.

Untuk menghindari perlu mengerjakan ulang fitur, umumnya disarankan agar pengembangan fitur tidak dimulai selama fase peninjauan. Sering kali, proses peninjauan komunitas mengungkap satu atau beberapa masalah yang mungkin memerlukan perubahan signifikan dalam implementasi yang diusulkan.

Catatan

Jika Anda ingin mengerjakan sesuatu yang sudah ada di backlog kami, Anda dapat menggunakan item kerja tersebut sebagai proposal Anda. Pastikan juga untuk mengomentari tugas yang memberi tahu pengelola bahwa Anda sedang berupaya menyelesaikannya.

Proses kontribusi

Untuk memulai, cukup ikuti langkah-langkah berikut:

  1. Fork repositori. Klik tombol "Fork" di kanan atas halaman dan ikuti alurnya.
  2. Buat cabang di fork Anda (di luar cabang utama ) untuk mempermudah mengisolasi perubahan apa pun sampai siap untuk pengiriman. Untuk perbaikan bug selama periode stabilisasi rilis, cari cabang terbaru prerelease/* . Fitur baru harus selalu masuk ke main.

Jika Anda baru menggunakan alur kerja Git, lihat pengantar ini dari Github.

Saat menambahkan perbaikan bug atau fitur, ikuti langkah-langkah berikut:

  1. Terapkan perbaikan bug atau fitur. Instruksi untuk membangun dan menyebarkan MRTK ada di Menyebarkan ke perangkat Hololens dan WMR. Ingatlah untuk mengikuti Pedoman Coding.
  2. Jika menambahkan fitur, tambahkan juga contoh adegan yang menunjukkan fitur tersebut.
  3. Jika menambahkan fitur eksperimental, maka menulis pengujian dan dokumentasi tidak diperlukan. Sebagai gantinya, ikuti panduan fitur eksperimental.
  4. Tambahkan pengujian untuk memverifikasi perbaikan/fitur bug. Instruksi untuk menulis dan menjalankan pengujian ada di UnitTests.
  5. Pastikan kode dan fitur didokumenkan seperti yang dijelaskan dalam Pedoman Dokumentasi.
  6. Pastikan kode berfungsi seperti yang dimaksudkan di semua platform. Silakan lihat Catatan rilis untuk daftar platform yang didukung. Untuk proyek Windows UWP, kode harus sesuai dengan WACK. Untuk melakukan ini, buat solusi Visual Studio, klik kanan proyek; Toko>Buat Paket Aplikasi. Ikuti perintah dan jalankan pengujian WACK. Pastikan semuanya berhasil.
  7. Ikuti petunjuk di Permintaan Pull saat membuat permintaan pull.