cara memberi nama proyek Anda
- project_name-7.25-1.0-alpha
- project_name-7.25-1.0-beta1
- project_name-7.25-1.0-dev2
- project_name-7.25-1.0-rc3
- project_name-7.25-1.0-stable4
- project_name-7.25-1.0-unstable5
mengikuti praktik terbaik?
12
Lihat Drupal.org untuk rilis konvensi penamaan dan penjelasan lebih lanjut .
Ringkasan:
rc = Rilis Calon, dianggap cocok oleh penulis untuk lokasi produksi.
rc : Calon rilis hanya boleh dibuat ketika semua masalah jenis bug kritis dilaporkan diperbaiki dalam antrian masalah proyek. Tag ini hanya boleh digunakan ketika pengembang percaya bahwa proyek siap digunakan di lokasi produksi. Tidak ada praktik terbaik resmi untuk berapa lama sebuah proyek harus menjadi kandidat rilis sebelum membuat rilis resmi .0, tetapi disarankan bahwa itu harus keluar selama setidaknya satu bulan dengan status diatur ke "perlu ditinjau". Jika sesuatu (misalnya bug kritis baru dilaporkan) mengharuskan untuk membuat rilis baru selama periode ini, kandidat rilis baru harus dibuat dan ini harus tetap selama setidaknya satu bulan dengan status diatur ke "perlu ditinjau".
Tidak apa-apa untuk menandai modul "rc" dengan masalah permintaan fitur luar biasa. Penulis modul tidak diharuskan untuk memenuhi setiap permintaan fitur pengguna dari posting modul ke antrian masalah.
Berikut adalah deskripsi dari tag rilis lain yang diizinkan:
tidak stabil : Proyek tidak dalam kondisi stabil. Mungkin ada banyak bug yang belum diperbaiki, termasuk masalah keamanan. API dapat berubah tanpa pemberitahuan. Skema basis data dapat berubah tanpa hook_update_Nditerapkan. Penggunaan dan API mungkin tidak didokumentasikan. Menginstal rilis baru yang tidak stabil mengharuskan untuk mencopot proyek, sehingga kehilangan semua data. Hanya untuk mereka yang menginginkan pratinjau awal proyek. Belum cocok untuk pengembangan bersama.
alfa : Sebagian besar kesalahan yang dilaporkan diselesaikan, tetapi mungkin masih ada masalah serius yang belum diketahui, termasuk masalah keamanan. Project tidak diuji secara menyeluruh, jadi mungkin juga ada banyak bug yang tidak diketahui. Ada README.txt / README.md yang mendokumentasikan proyek dan API-nya (jika ada). Skema API dan DB mungkin dapat digunakan, tetapi semua perubahan ini dilaporkan dalam catatan rilis, dan hook_update_Ndiimplementasikan untuk menyimpan data melalui perubahan skema, tetapi tidak ada jalur peningkatan / pembaruan lainnya. Tidak cocok untuk lokasi produksi. Target audiens adalah pengembang yang ingin berpartisipasi dalam pengujian, debugging, dan pengembangan proyek.
beta : Semua kehilangan data penting dan bug keamanan telah diatasi. Jika modul menawarkan API, itu harus dianggap beku, sehingga mereka yang menggunakan API dapat mulai memutakhirkan proyek mereka. Jika ini merupakan peningkatan atau pembaruan proyek, jalur peningkatan / pembaruan harus ditawarkan, dan harus memungkinkan bagi pengguna yang ada untuk meningkatkan / memperbarui ke versi baru tanpa kehilangan data. Semua dokumentasi harus mutakhir. Target audiens adalah pengembang yang ingin berpartisipasi dalam pengujian, debugging dan pengembangan proyek, dan pengembang proyek lain yang menghubungkan proyek. Biasanya tidak cocok untuk lokasi produksi, tetapi dapat digunakan di beberapa lokasi produksi jika administrator situs mengetahui proyek dengan baik, dan tahu untuk menangani masalah yang tersisa.
String "dev" dan "stable" tidak valid sebagai bagian dari tag rilis, tetapi rilis pengembangan yang tidak ditandai diasumsikan sebagai "dev" dan diberikan deskripsi seperti "7.x-1.x-dev" oleh Drupal .org merilis sistem pengemasan untuk menunjukkan bahwa mereka adalah rilis pengembangan yang tidak diberi tag.
Semua tag rilis harus diakhiri dengan angka. Jumlahnya hanya untuk membedakan rilis dari kelas yang sama. Yang pertama diberi nomor "1" (seperti dalam "alpha1"), yang selanjutnya "2", dan seterusnya.
PS. String yang menunjukkan rilis (seperti "7.x-1.0-alpha4") dikenal sebagai "tag rilis" dalam bahasa git, bukan "nama". Dan Anda tidak pernah menggunakan versi minor drupal sebagai bagian dari tag, Anda menggunakan "x" sebagai gantinya.