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.