Perubahan paket massal
Dari waktu ke waktu, perubahan diperlukan pada sekelompok paket. Ketika perubahannya kompleks atau jumlah paket yang terpengaruh besar, koordinasi sangat diperlukan untuk menghindari kebingungan dan pemborosan upaya. Pengajuan bug secara massal mungkin diperlukan, yang harus dilakukan dengan hati-hati. Halaman ini mencoba menjelaskan beberapa langkah yang perlu diambil ketika perubahan massal diperlukan dan menguraikan prosedur untuk pengajuan bug massal jika hal tersebut diperlukan.
Semua orang sibuk, dan pengelola paket seringkali adalah relawan. Banyak pengelola juga menerima terlalu banyak email dari bugzilla, sehingga bug tambahan seringkali tidak diinginkan. Sedikit upaya ekstra di awal dapat menghasilkan proses yang lebih lancar bagi semua orang, meskipun ini dapat memakan waktu sedikit lebih lama. Dan seringkali pengajuan bug massal yang sebenarnya dapat dihindari.
Dapatkan konsensus mengenai perubahan yang diperlukan
Pertama, Anda harus memposting ke daftar pengembang Fedora dan mendapatkan konsensus untuk perubahan yang ingin Anda lakukan. Tidak peduli seberapa sederhana atau diperlukan menurut Anda, mungkin ada cara yang lebih baik untuk melakukan sesuatu atau perubahan tersebut mungkin tidak diperlukan karena alasan lain. Bagian dari diskusi ini harus berupa pengembangan serangkaian instruksi ringkas yang perlu diikuti oleh para pengemas agar dapat memperbaiki paket yang terpengaruh. Ini tentu saja dapat merujuk pada dokumen eksternal, tetapi para pengemas seharusnya dapat memahami gambaran dasar mengenai perubahan yang diperlukan tanpa harus mencari tautan.
Tunjukkan paket-paket yang perlu diubah
Kumpulan paket yang akan memerlukan perubahan harus diposting ke daftar devel-announce segera setelah kumpulan tersebut ditentukan. Untuk membuat segalanya semudah mungkin bagi para pengelola yang terlibat, ini harus dalam bentuk dua daftar, satu daftar berisi paket dan pemiliknya, dan yang lain berisi daftar pengelola dan paket mereka. Ini memudahkan satu pengelola untuk melihat berapa banyak pekerjaan yang harus dilakukan, dan juga bagi orang lain untuk memiliki gambaran tentang siapa yang mungkin memerlukan bantuan. Untuk kemudahan, utilitas yang akan menghasilkan daftar ini berdasarkan file nama paket tersedia dari sebagai "find-package-maintainers".
Daftar-daftar ini harus diperbarui sepanjang diskusi saat paket diperbaiki, dan juga harus menyertakan instruksi untuk memperbaiki paket yang disebutkan di atas.
Pembersihan otomatis
Pembersihan paket otomatis dianjurkan. Jika dimungkinkan untuk membuat perubahan yang relevan secara otomatis dengan kemungkinan kecil terjadinya efek samping yang tidak diinginkan, maka hal ini setidaknya harus dipertimbangkan, bahkan jika itu hanya dapat dilakukan untuk sebagian dari paket yang terpengaruh. Rincian aktual dari proses ini (seperti apakah build diperlukan atau jika perubahan hanya perlu di-commit) hampir pasti bergantung pada perubahan yang terlibat dan harus dirumuskan selama diskusi. Pengemas yang terbukti dapat melakukan pembersihan otomatis tanpa menggunakan pull request dengan mendorong langsung ke kontrol sumber.
Tinjau teks pengumuman / bug
Mintalah daftar atau beberapa pengelola yang tertarik untuk meninjau teks yang ingin Anda kirim ke daftar devel-announce (langkah berikutnya) dan yang ingin Anda gunakan dalam teks bug Anda. Ini akan membantu membuat teks Anda jelas dan mudah dipahami serta bebas dari kesalahan ketik atau kesalahan sederhana lainnya. Pastikan beberapa orang melihat teks Anda dan setuju bahwa teks tersebut menjelaskan masalah dengan jelas beserta solusinya. Teks ini harus menyertakan instruksi yang dikembangkan di atas.
Umumkan ke devel-announce
Setelah Anda memiliki gambaran yang jelas tentang perubahan yang diperlukan, posting email yang jelas mengenai perubahan yang diperlukan ke daftar devel-announce. Tunggu setidaknya satu minggu untuk memungkinkan para pengelola melakukan perubahan atau mengajukan pertanyaan lebih lanjut kepada Anda tentang perubahan tersebut di daftar pengembang. Jika perubahan harus dilakukan karena tenggat waktu tertentu, harap catat hal itu dalam email. Jika Anda bermaksud meminta provenpackager atau proses otomatis untuk membuat perubahan pada semua paket yang belum diubah, harap catat hal itu juga dalam email.
Ajukan bug pelacak
Sekarang Anda dapat mengajukan bug pelacak di bugzilla dan bug terhadap semua paket yang masih memerlukan perubahan. Perhatikan bahwa Anda harus memeriksa untuk memastikan para pengelola belum membuat perubahan dan hanya mengajukan bug terhadap paket-paket yang belum diubah.
Hal-hal yang perlu dicatat dalam bug
-
Pastikan Anda mencatat rilis mana yang menurut Anda harus diperbaiki, atau jika hanya rawhide yang diperlukan.
-
Catat apakah Anda ingin pembaruan diajukan hanya untuk perubahan ini, atau apakah perubahan tersebut dapat didorong saat berikutnya ada alasan lain untuk memperbarui.
-
Tautkan ke pedoman spesifik yang terpengaruh.
-
Jika perubahannya kecil, harap sertakan apa yang perlu ditambahkan atau dihapus oleh pengelola secara spesifik dari spec mereka.
-
Jika perubahannya besar, harap sertakan ringkasan tentang perubahan apa yang diperlukan. Tautan ke halaman eksternal dengan dokumentasi lengkap tentu saja diperlukan, tetapi seorang pengemas seharusnya dapat memperoleh pemahaman dasar tentang perubahan dari apa yang disertakan dalam bug itu sendiri. Tautan ke diskusi daftar email saja tidak cukup.
-
Catat pengumuman dan thread daftar email apa pun di mana perubahan tersebut telah didiskusikan.
-
Catat tenggat waktu apa pun yang setelahnya provenpackager mungkin turun tangan dan membuat perubahan.
-
Catat di mana para pengelola dapat memberikan umpan balik atau meminta informasi lebih lanjut jika bug tidak jelas.
-
Sertakan nama paket dalam baris ringkasan setiap bug anak, sehingga memungkinkan untuk melihat dengan cepat komponen yang terpengaruh dalam tampilan pohon.
Want to help? Learn how to contribute to Fedora Docs ›