[ English | 中文 (简体, 中国) | русский | português (Brasil) | नेपाली | 한국어 (대한민국) | Indonesia | français | español | esperanto | English (United Kingdom) | Deutsch ]
Catatan Rilis¶
Catatan rilis untuk sebuah patch harus dimasukkan dalam patch dengan perubahan terkait jika memungkinkan. Ini memungkinkan pelacakan yang lebih sederhana. Ini juga memungkinkan pick cherry tunggal dilakukan jika perubahan tersebut di-backport ke rilis sebelumnya. Dalam beberapa kasus, seperti fitur yang disediakan melalui beberapa patch, catatan rilis dapat dilakukan dalam tinjauan lanjutan.
Jika hal berikut ini berlaku untuk patch, catatan rilis diperlukan:
Deployer perlu mengambil tindakan saat upgrading
Fitur baru diimplementasikan
Fungsi telah dihapus (mudah-mudahan itu sudah ditinggalkan)
Perilaku saat ini diubah
Opsi konfigurasi baru ditambahkan bahwa deployer harus mempertimbangkan perubahan dari standar
Bug keamanan diperbaiki
Catatan
Catatan rilis disarankan jika bug lama atau penting diperbaiki. Kalau tidak, catatan rilis tidak diperlukan.
Tidak disarankan agar catatan rilis individual menggunakan bagian **prelude ** karena untuk highlight rilis.
Peringatan
Hindari mengubah file catatan rilis yang sudah ada meskipun itu terkait dengan perubahan Anda. Jika Anda memodifikasi file catatan rilis dari rilis yang lalu, seluruh konten akan ditampilkan dalam rilis terbaru. Satu-satunya kasus yang diizinkan adalah memperbarui catatan rilis dalam rilis yang sama.
Jika Anda perlu memperbarui catatan rilis dari rilis yang lalu, edit file catatan rilis yang sesuai di cabang stabil secara langsung.
Horizon menggunakan reno <https://docs.openstack.org/reno/latest/user/usage.html> _ untuk menghasilkan catatan rilis. Silakan baca dokumen untuk detailnya. Singkatnya, gunakan
$ tox -e venv-docs -- reno new <bug-,bp-,whatever>
Kemudian edit file sampel yang telah dibuat dan dorong dengan perubahan Anda.
Untuk melihat hasilnya:
$ git commit # Commit the change because reno scans git log.
$ tox -e releasenotes
Kemudian lihat file catatan rilis yang dihasilkan di releasenotes/build/html di browser favorit Anda.