diff --git a/config.rb b/config.rb index cee748b..0268e43 100644 --- a/config.rb +++ b/config.rb @@ -39,6 +39,10 @@ $languages = { l'instant et aider à la traduire.", new: "Une nouvelle version est disponible" }, + "id-ID" => { + name: "Indonesia", + new: "Ada versi baru tersedia" + }, "it-IT" => { name: "Italiano", notice: "L'ultima versione (#{$last_version}) non è ancora disponibile in diff --git a/source/id-ID/1.0.0/index.html.haml b/source/id-ID/1.0.0/index.html.haml new file mode 100644 index 0000000..61289b8 --- /dev/null +++ b/source/id-ID/1.0.0/index.html.haml @@ -0,0 +1,327 @@ +--- +description: Pencatatan Changelog +title: Pencatatan Changelog +language: id-ID +version: 1.0.0 +--- + +- changelog = "https://github.com/olivierlacan/keep-a-changelog/blob/master/CHANGELOG.md" +- gemnasium = "https://gemnasium.com/" +- gh = "https://github.com/olivierlacan/keep-a-changelog" +- issues = "https://github.com/olivierlacan/keep-a-changelog/issues" +- semver = "http://semver.org/" +- shields = "http://shields.io/" +- thechangelog = "http://5by5.tv/changelog/127" +- vandamme = "https://github.com/tech-angels/vandamme/" +- iso = "http://www.iso.org/iso/home/standards/iso8601.htm" +- ghr = "https://help.github.com/articles/creating-releases/" +- aditya = "https://github.com/adityapurwa/" + +.header + .title + %h1 Pencatatan Changelog + %h2 Standarisasi pencatatan Changelog untuk kolaborasi yang lebih baik + + = link_to changelog do + Versi + %strong= current_page.metadata[:page][:version] + + %pre.changelog= File.read("CHANGELOG.md") + +.answers + %h3#what + %a.anchor{ href: "#what", aria_hidden: "true" } + Apa itu changelog? + + %p + Changelog adalah sebuah file yang berisi daftar perubahan yang + diurutkan secara kronologis untuk setiap versi dari sebuah project. + + %h3#why + %a.anchor{ href: "#why", aria_hidden: "true" } + Kenapa perlu untuk mencatat changelog? + + %p + Supaya pengguna dan kontributor lebih mudah melihat perubahan + apa saja yang terjadi di setiap rilis (atau versi) dari sebuah project. + + %h3#who + %a.anchor{ href: "#who", aria_hidden: "true" } + Siapa yang butuh changelog? + + %p + Semua orang membutuhkannya. Baik pengguna ataupun pengembang, setiap + orang yang menggunakan perangkat lunak adalah manusia yang peduli dengan + apa yang ada di perangkat lunak tersebut. Mereka ingin tahu apa + dan kenapa terjadi perubahan. + +.good-practices + %h3#how + %a.anchor{ href: "#how", aria_hidden: "true" } + Bagaimana cara membuat changelog yang baik? + + %h4#principles + %a.anchor{ href: "#principles", aria_hidden: "true" } + Prinsip Dasar + + %ul + %li + Changelog ditulis untuk manusia, bukan mesin. + %li + Harus ada catatan untuk setiap versi. + %li + Setiap tipe perubahan yang sama harus dikelompokkan. + %li + Versi dan seksi harus ditulis dalam bentuk link. + %li + Versi yang terakhir harus ditulis di paling atas. + %li + Tiap catatan harus disertai dengan tanggal. + %li + Berikan informasi jika kalian menggunakan #{link_to "Semantic Versioning", semver}. + + %a.anchor{ href: "#types", aria_hidden: "true" } + %h4#types Jenis-jenis perubahan + + %ul + %li + %code Added/Ditambahkan + untuk fitur yang baru. + %li + %code Changed/Dirubah + untuk perubahan di fitur yang sudah ada. + %li + %code Deprecated/Akan Dhilangkan + untuk fitur yang akan dihapus dalam waktu dekat. + %li + %code Removed/Dihilangkan + untuk fitur yang sudah dihapus. + %li + %code Fixed/Diperbaiki + untuk setiap perbaikan bugs. + %li + %code Security/Keamanan + jika ada celah keamanan. + +.effort + + %h3#effort + %a.anchor{ href: "#effort", aria_hidden: "true" } + Bagaimana usaha untuk menjaga changelog tetap tercatat dengan benar? + + %p + Sisakan bagian Unreleased/Belum Dirilis di bagian paling atas + file changelog untuk mencatat perubahan yang akan datang. + + + %p Hal ini berguna untuk dua hal: + + %ul + %li + People can see what changes they might expect in upcoming releases + Orang-orang bisa melihat perubahan apa saja yang akan datang. + %li + Saat waktu rilis datang, tinggal pindahkan bagian Unreleased/Belum Dirilis + ke catatan rilis versi baru di bawah. + +.bad-practices + %h3#bad-practices + %a.anchor{ href: "#bad-practices", aria_hidden: "true" } + Apakah changelog bisa menjadi tidak bermanfaat? + + %p Bisa, berikut beberapa skenario ketika changelog menjadi tidak bermanfaat: + + %h4#log-diffs + %a.anchor{ href: "#log-diffs", aria_hidden: "true" } + Menggunakan Commit log diffs sebagai changelog + + %p + Menggunakan commit log diffs (catatan perbedaan setiap commit) bisa + membuat changelog susah untuk dibaca. Commit dengan judul yang tidak jelas, + dokumentasi perubahan, dan sebagainya, malah akan membuat + changelog terlalu berisik dan susah dibaca. + + %p + The purpose of a commit is to document a step in the evolution of + the source code. Some projects clean up commits, some don't. + Tujuan utama dari commit adalah untuk mencatat setiap perubahan dari source + code. Beberapa project mengatur commitnya, beberapa tidak. + + %p + Tujuan dari changelog adalah untuk mencatat perubahan yang pantas + untuk dicatat, bisa jadi beberapa commit dijadikan satu catatan + untuk lebih memudahkan pembaca. + + %h4#ignoring-deprecations + %a.anchor{ href: "#ignoring-deprecations", aria_hidden: "true" } + Mengabaikan Depcreations (fitur yang akan dihilangkan) + + %p + Saat menaikkan versi, harus ditulis dengan jelas apa saja + yang kira-kira bisa membuat sistem tidak berjalan. Sebaiknya + terdapat versi yang mencatat apa saja yang akan dihilangkan, + lalu menghapus fitur yang dihilangkan, dan naikkan lagi ke versi + dengan fitur yang sudah dihilangkan. + + %p + Jika kalian tidak merubah apapun, tetap catat fitur yang akan + dihilangkan, fitur yang sudah dihilangkan, dan perubahan-perubahan + lain yang bisa membuat sistem tidak berjalan. + + + %h4#confusing-dates + %a.anchor{ href: "#confusing-dates", aria_hidden: "true" } + Perbedaan Format Tanggal + + %p + Format tanggal regional berbeda-beda sesuai dengan budaya masing-masing, + dan seringkali perbedaan ini susah untuk dipahami dan dimengerti. + Penggunaan format tanggal 2017-07-17 lebih mudah untuk dimengerti, + karena diurutkan berdasarkan unit terbesar: tahun, bulan, dan tanggal. + Format ini juga merupakan #{link_to "ISO standard", iso}, sehingga + inilah yang dipakai untuk pencatatan changelog. + + %aside + Ada beberapa permasalahan lainnya, bantu kami dengan beberapa antipatterns + dengan = link_to "mengirimkan issue", issues atau kirimkan pull request. + +.frequently-asked-questions + %h3#frequently-asked-questions + %a.anchor{ href: "#frequently-asked-questions", aria_hidden: "true" } + Pertanyaan yang Sering Ditanyakan + + %h4#standard + %a.anchor{ href: "#standard", aria_hidden: "true" } + Is there a standard changelog format? + Apakah ada standar untuk format changelog? + + %p + Tidak, ada format GNU untuk changelog, atau format 2 paragraf GNU NEWS. + Keduanya tidak benar-benar cukup, gunakan format yang disetujui tim masing-masing. + + %p + Project ini ditujukan untuk + = link_to "membuat aturan changelog yang lebih baik", changelog + berdasarkan observasi beberapa changelog di komunitas open source + dan menyatukan mereka. + + %p + Kritik yang membangun, diskusi, dan saran untuk perbaikan + = link_to "sangat diterima.", issues + + + %h4#filename + %a.anchor{ href: "#filename", aria_hidden: "true" } + What should the changelog file be named? + Apa nama file yang cocok untuk file changelog? + + %p + Gunakan nama CHANGELOG.md, beberapa project + menggunakan HISTORY, NEWS atau RELEASE. + + %p + Sebenarnya tidak terlalu susah untuk menamai file changelog, cukup + berikan nama yang mudah dikenali oleh orang-orang + supaya mudah untuk dibaca. + + %h4#github-releases + %a.anchor{ href: "#github-releases", aria_hidden: "true" } + Apa itu GitHub Releases? + + %p + #{link_to "Github Release", ghr} adalah salah satu + insiatif dari GitHub untuk membuat changelog berdasarkan git tags, + contohnya, tag dengan nama v1.0.0. Isi dari changelog + bisa ditulis manual atau menggunakan pesan yang ditulis bersamaan dengan + tags. + + %p + GitHub Releases membuat changelog yang tidak portable dan hanya bisa + bekerja dengan baik di lingkup GitHub. Sangat mungkin untuk + membuat GitHub Releases terlihat mirip dengan format pencatatan changelog + yang dijelaskan di sini, tapi butuh usaha ekstra. + + %p + Versi GitHub releases yang sekarang juga tidak terlalu umum + untuk orang-orang, dan hanya bisa dibuka melalui sub menu + di GitHub, berbeda dengan file-file seperti + (README, CONTRIBUTING, dsb.) yang + langsung terlihat saat project pertama kali dibuka. Keterbatasan lainnya + adalah tidak adanya link di GitHub releases. + + %h4#automatic + %a.anchor{ href: "#automatic", aria_hidden: "true" } + Apakah Changelog Bisa Diparse Secara Otomatis? + + %p + Susah, karena orang-orang menggunakan versi dan format + changelog yang berbeda-beda. + + %p + #{link_to "Vandamme", vandamme} adalah Ruby Gem yang dibuat oleh tim + #{link_to "Gemnasium", gemnasium} yang bisa memparse (but + not all) changelog beberapa project open source. + + + %h4#yanked + %a.anchor{ href: "#yanked", aria_hidden: "true" } + Bagaimana dengan Rilis YANKED (rilis yang dibatalkan)? + + %p + Rilis yang dibatalkan adalah rilis yang dibatalkan, bisa jadi + karena ada bug yang fatal dan permasalahan keamanan. Versi + ini sering tidak dimasukkan ke changelog, padahal seharusnya ditulis + sebagaimana berikut. + + %p ## 0.0.5 - 2014-12-13 [YANKED/DIBATALKAN] + + %p + Tag [YANKED/DIBATALKAN] ditulis dengan jelas supaya + orang memperhatikannya, dan dikurung dengan kurung kotak supaya + mudah untuk diparse. + + + %h4#rewrite + %a.anchor{ href: "#rewrite", aria_hidden: "true" } + Bolehkan Menulis Ulang Changelog? + + %p + Tentu saja, ada banyak alasan bagus untuk menulis ulang changelog, + salah satunya untuk rilis-rilis yang lupa untuk dituliskan di + beberapa project. + + %p + Juga sangat mungkin saat menulis ulang, kalian ingat tentang perubahan + yang bisa membuat sistem tidak bekerja yang belum dituliskan. Dalam hal ini, + sangat penting untuk merubah changelog supaya datanya lebih akurat. + + + %h4#contribute + %a.anchor{ href: "#contribute", aria_hidden: "true" } + Bagaimana Saya Bisa Berkontribusi? + + %p + Dokumen ini bukan kebenaran absolut, ini hanyalah opini yang dikumpulkan + dari beberapa informasi dan contoh yang kami kumpulkan. + + %p + Ini karena kami ingin komunitasi terus berdiskusi untuk mencapai konsensus + yang terbaik untuk pencatatan changelog. + + %p + Jadi silahkan, #{link_to "kirimkan saran", gh}. + + %h4#about-translation + %a.anchor{ href: "#about-translation", aria_hidden: "true" } + Tentang Terjemahan Bahasa Indonesia + + %p + Terjemahan Bahasa Indonesia diterjemahkan oleh #{link_to "Aditya Purwa", aditya}, silahkan + sampaikan jika ada terjemahan yang lebih baik. + +.press + %h3 Conversations + %p + Kami mengisi acara di #{link_to "The Changelog podcast", thechangelog} + untuk berbicara tentang kenapa maintainer dan kontributor harus peduli + dengan changelog, dan motivasi dari project ini.