mirror of
https://github.com/olivierlacan/keep-a-changelog.git
synced 2025-07-31 01:34:18 +02:00
add indonesian translation
This commit is contained in:
Aditya Purwa
parent
cc3abfd60c
commit
5fab948a80
@ -39,6 +39,10 @@ $languages = {
|
|||||||
l'instant et <a href='#{issues_url}'>aider à la traduire</a>.",
|
l'instant et <a href='#{issues_url}'>aider à la traduire</a>.",
|
||||||
new: "Une nouvelle version est disponible"
|
new: "Une nouvelle version est disponible"
|
||||||
},
|
},
|
||||||
|
"id-ID" => {
|
||||||
|
name: "Indonesia",
|
||||||
|
new: "Ada versi baru tersedia"
|
||||||
|
},
|
||||||
"it-IT" => {
|
"it-IT" => {
|
||||||
name: "Italiano",
|
name: "Italiano",
|
||||||
notice: "L'ultima versione (#{$last_version}) non è ancora disponibile in
|
notice: "L'ultima versione (#{$last_version}) non è ancora disponibile in
|
||||||
|
|||||||
327
source/id-ID/1.0.0/index.html.haml
Normal file
327
source/id-ID/1.0.0/index.html.haml
Normal file
@ -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 <em>manusia</em>, 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 <code>Unreleased/Belum Dirilis</code> 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 <code>Unreleased/Belum Dirilis</code>
|
||||||
|
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 <code>2017-07-17</code> 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 <code>CHANGELOG.md</code>, beberapa project
|
||||||
|
menggunakan <code>HISTORY</code>, <code>NEWS</code> atau <code>RELEASE</code>.
|
||||||
|
|
||||||
|
%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 <code>v1.0.0</code>. 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
|
||||||
|
(<code>README</code>, <code>CONTRIBUTING</code>, 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 <code>## 0.0.5 - 2014-12-13 [YANKED/DIBATALKAN]</code>
|
||||||
|
|
||||||
|
%p
|
||||||
|
Tag <code>[YANKED/DIBATALKAN]</code> 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, <strong>#{link_to "kirimkan saran", gh}</strong>.
|
||||||
|
|
||||||
|
%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.
|
||||||
Loading…
x
Reference in New Issue
Block a user