Changelog dan Catatan Rilis Dijelaskan untuk Non-Pengembang

Diterbitkan: 2017-10-23

Anda mendapatkan pembaruan untuk iOS atau Android di ponsel cerdas Anda. Gamer mendapatkan patch konten baru untuk World of Warcraft atau Call of Duty. Plugin dan tema WordPress mendapatkan fitur baru. Perangkat lunak yang Anda gunakan setiap hari diperbarui secara berkala. Ketika itu terjadi, log perubahan diterbitkan yang menunjukkan kepada Anda apa yang telah diperbaiki atau ditambahkan.

Masalah dengan changelog ini sering kali menjadi sangat sulit untuk dibaca dan dipahami kecuali Anda…

  • terlibat langsung dengan proyek
  • seorang pengembang perangkat lunak yang terlatih dalam membaca dokumen dan jargon teknologi

Bagi kebanyakan orang, bahkan struktur changelog menakutkan, yang membuat mereka mengabaikan catatan sama sekali. Itu buruk karena sejumlah alasan, tidak sedikit di antaranya adalah kegagalan keseluruhan Tampilan Widget dan masalah seperti itu (yang sayangnya cukup umum).

Jadi, mari kita uraikan apa itu changelog, cara membaca catatan rilis, dan pastikan Anda tetap up-to-date dan mendapatkan informasi sebanyak mungkin.

Nada dan Gaya

Perusahaan dan pengembang yang berbeda mendekati log perubahan mereka secara berbeda. Beberapa langsung dan memberi tahu Anda dengan tepat apa yang dilakukan pembaruan dalam hal teknis, sementara yang lain (seperti yang dapat Anda lihat pada contoh di bawah dari pembaruan Slack baru-baru ini) menggunakan pendekatan yang lebih mudah dibaca (dan seringkali lucu) untuk memberi tahu pengguna tentang hal-hal baru.

log perubahan

Misalnya, WordFence adalah plugin keamanan yang tidak boleh sembrono dalam catatan mereka. Terlalu banyak orang yang terlalu banyak menungganginya, sementara keseluruhan merek Slack adalah tentang mudah didekati dan menyenangkan.

log perubahan

Secara umum, ini adalah dua jenis catatan rilis yang akan Anda lihat. Namun, jika Anda terlibat dalam pengembangan, Anda akan melihat log perubahan yang ditulis jauh lebih tidak jelas. Kecuali Anda mengaduk-aduk Github, Anda tidak akan menemukan apa pun yang benar-benar tidak dapat dipahami.

Pentingnya isu-isu yang ditangani oleh perubahan juga menentukan nada. Jika Slack, misalnya, adalah korban pelanggaran data dari kerentanan kode (Tuhan melarang), catatan tempel untuk perbaikan akan suram dan meyakinkan.

Pada akhirnya, meskipun,

Memahami Rilis Poin dan Nomor Versi

Struktur utama changelog cukup sederhana. Anda memiliki nomor versi yang (biasanya) terdiri dari dua atau tiga angka yang dipisahkan oleh desimal— 2.39 atau 1.3.37 dan daftar berpoin yang menyertai setiap rilis.

Masing-masing angka tersebut memiliki fungsi tertentu. Kami akan menguraikannya secara umum sehingga Anda akan tahu apa yang Anda lihat. Karena Anda akan selalu mendapat pemberitahuan bahwa Anda memiliki pembaruan yang tertunda.

3.xx

Angka pertama dalam changelog menunjukkan versi utama perangkat lunak, rilis utama, berapa kali perangkat lunak telah dirilis dengan peningkatan signifikan yang mengubah fungsionalitas secara keseluruhan.

Misalnya saat Anda memperbarui iPhone ke iOS 11, Anda secara teknis memperbarui ke versi 11.0.0. Sama ketika Anda mendapatkan Android Oreo—ini versi 8.0. Umumnya ketika nomor pertama dari perangkat lunak diperbarui, Anda akan mendapatkan pengalaman yang sangat berbeda dari sebelumnya.

Jika Anda seorang gamer, pikirkan tentang ekspansi sebagai rilis besar. Rilis pertama World of Warcraft pada tahun 2004 adalah versi 1.0, sedangkan The Burning Crusade adalah 2.0, dan ekspansi saat ini, Legion, adalah 7.0.

Dengan Divi, rilis dari 2.7 ke 3.0 adalah pengerjaan ulang Divi Builder ke Visual Builder baru, yang membawa perubahan besar bagi semua orang.

x.1.x

Digit kedua adalah tempat Anda melihat fitur baru yang ditambahkan atau bug diperbaiki. Digit kedua (dan ketiga) disebut pelepasan titik karena dibaca dengan keras seperti “tujuh koma tiga koma empat”.

Penambahan ini dapat mengubah aspek aplikasi atau plugin, tetapi bukan fungsionalitas dasar seperti rilis utama. Saat Divi menambahkan modul baru atau saat iOS atau Android menambahkan emoji baru, Anda akan mendapatkannya di versi 3.1 atau 10.3.

Untuk plugin WordPress, lihat Yoast SEO. Versi 5.5.0 memberikan beberapa perbaikan bug dan peningkatan, tetapi tidak ada yang mengejutkan di sini. Pada dasarnya, Anda tidak perlu mempelajari kembali cara kerja perangkat lunak dengan rilis titik.

log perubahan

Rilis poin ini akan terjadi ketika Anda mendapatkan level atau sistem baru di video game. Seperti yang Anda lihat di bawah, versi 2.2. ke 2.3 aplikasi seluler Kingdom Hearts menambahkan sistem hewan peliharaan. Itu tidak mengubah cara permainan dimainkan, tetapi menambahkan sesuatu di atas apa yang sudah ada.

log perubahan

xx7

Dengan digit ketiga dan terakhir dari catatan rilis, changelog Anda kemungkinan akan penuh dengan perbaikan bug kecil (paling baik). Atau mungkin beberapa perubahan/perbaikan latar belakang yang mungkin tidak Anda sadari.

Facebook terkenal dengan rilis poin semacam ini. Aplikasi mereka diperbarui setiap minggu, dan mereka mungkin tidak banyak berubah yang (sebagian besar) pengguna akan perhatikan dengan penggunaan sehari-hari.

Seringkali, rilis poin kecil ini disebut "perbaikan terbaru". Itu hanya tambalan yang mengatasi masalah yang sebagian besar pengguna bahkan tidak tahu ada. Sebagian besar perbaikan terbaru ini memperbaiki sesuatu seperti font yang rusak pada versi browser tertentu. Atau mungkin kebocoran memori pada sistem operasi tertentu. Seringkali perbaikan ini diberi label sebagai sesuatu yang umum seperti "masalah kompatibilitas."

Terkadang, Anda akan mendapatkan perbaikan terbaru untuk masalah yang dilihat pengembang sebagai sesuatu yang tidak dapat menunggu untuk patch konten berikutnya (atau pembaruan yang dijadwalkan secara rutin). Sekali lagi, itu mungkin atau mungkin tidak memengaruhi Anda.

Seperti yang Anda lihat di pembaruan yang dibuat untuk Yoast dari 5.3.2 ke 5.3.3, pembaruannya relatif kecil tetapi penting dalam "situasi tertentu."

log perubahan

Changelog in the Wild

Sebagai contoh, lihat catatan rilis/changelog untuk Divi pada beberapa rilis utama. Antara 2.7 dan 3.0.1, Anda dapat melihat jenis perubahan yang dibuat. Beberapa mayor (rilis Visual Builder baru) dan beberapa minor (perubahan font hanya untuk WordPress 4.6).

version 3.0.1 ( updated 09-08-2016 )
- Fixed various third party module conflicts in the Visual Builder.
- The save button will now appear automatically when attempting to leave the Visual Builder without saving.
- Fixed issue with content width misalignment in the Visual Builder while boxed layout was enabled.
- Fixed occurrences where the in-line editor did not save properly
- Added footer credits editor to Theme Customizer.
- Fixed issues with IE11 and the Slider Module when viewed inside the Visual Builder.
- Fixed problem with the rendering of the divider module height setting in the Visual Builder.
	

version 3.0 ( updated 09-07-2016 )
- Introducing the brand new Visual Builder: https://www.elegantthemes.com/blog/theme-releases/divi-3

version 2.7.10 ( updated 08-18-2016 )
- Fixed the issue with the Divi Builder not loading on some websites due to loading delay of TinyMCE in the latest version of WordPress.


version 2.7.9 ( updated 08-15-2016 )
- Fixed settings page font issues in WordPress 4.6

Kami saat ini berada di versi 3.0.78 pada saat tulisan ini dibuat. Sampai sekarang, perubahannya adalah penambahan dan penyesuaian yang relatif halus. Mereka penting dan luar biasa, dan kami sangat bangga dengan mereka, tetapi 78 pembaruan dari rilis 3.0.0 hingga sekarang berulang untuk membuat anggota Elegant Themes hidup lebih baik. Ketika 3.1 datang, Anda tahu itu akan menjadi luar biasa.

Dan 4.0? Man, oh, man… kita hanya bisa membayangkan.

Perhatikan dengan seksama Changelog Anda

Anda harus selalu membaca changelog yang disertakan dengan plugin, aplikasi, atau pembaruan tema apa pun. Seperti disebutkan dalam artikel Wordfence yang saya tautkan di atas, plugin memang dijual. Bahkan jika Anda memercayai pengembang asli (dan yang baru mungkin sama tepercayanya), Anda harus menyadari perubahan kepemilikan itu.

Changelog adalah tempat Anda akan mengetahui tentang hal semacam itu. Tidak setiap pembaruan dan penambahan akan mengubah pengalaman Anda. Itu selalu merupakan hal yang baik untuk setidaknya melirik catatan untuk melihat apa yang berbeda. Tetap terinformasi pasti bernilai 30 detik yang diperlukan untuk membaca catatan.

Dan inilah masalahnya: jika Anda tidak sepenuhnya memahami apa yang Anda baca, tidak apa-apa. Sebenarnya, itu normal. Changelog adalah dokumen transparansi dan catatan, bukan pembaruan triwulanan atau buletin email.

Meskipun ini berbahaya untuk dikatakan, perasaan saya adalah bahwa jika Anda tidak mengerti apa yang ada di changelog, maka masalah itu mungkin tidak masalah bagi Anda. (Dan jika mereka melakukannya, mereka juga penting bagi orang lain, siapa yang dapat dan akan membaginya untuk orang lain secara online.)

Yang penting adalah Anda memahami struktur dasar dari catatan rilis. Anda harus tahu apa arti angka dan istilah. Dan pada akhirnya Anda akan belajar cara memindai changelog untuk menemukan informasi penting.

Anda tidak perlu menjadi pengembang (atau bahkan teknisi) untuk memanfaatkan changelog. Anda hanya perlu tahu apa yang harus dicari.

Thumbnail artikel oleh r.kathesi / shutterstock.com