Skip to content

Commit 4378874

Browse files
committed
Update Ruby repository guide from Subversion to Git (id)
1 parent bf4ba33 commit 4378874

File tree

1 file changed

+46
-81
lines changed

1 file changed

+46
-81
lines changed

id/community/ruby-core/index.md

Lines changed: 46 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -12,65 +12,40 @@ Sehingga, dari mana Anda memulai?
1212

1313
Topik seputar pengembangan Ruby yang dibahas disini adalah:
1414

15-
* [Menggunakan Subversion untuk Memonitor Pengembangan Ruby](#following-ruby)
16-
* [Bagaimana Menggunakan Git pada Repository Utama Ruby](#git-ruby)
15+
* [Menggunakan Git untuk Memonitor Pengembangan Ruby](#following-ruby)
1716
* [Menyempurnakan Ruby, Patch by Patch](#patching-ruby)
18-
* [Peraturan untuk Developer Inti](#coding-standards)
17+
* [Peraturan untuk Core Developer](#coding-standards)
1918

20-
### Menggunakan Subversion untuk Memonitor Pengembangan Ruby
19+
### Menggunakan Git untuk Memonitor Pengembangan Ruby
2120
{: #following-ruby}
2221

23-
Mendapatkan kode sumber Ruby terbaru dengan melakukan *checkout* sebagai anonim
24-
pada repositori [Subversion][1]. Masukan perintah berikut pada *console* Anda:
22+
Repositori utama saat ini dari kode sumber Ruby terbaru adalah
23+
[git.ruby-lang.org/ruby.git][gitrlo].
24+
Ada juga sebuah [mirror pada GitHub][7]. Biasanya, mohon gunakan *mirror* ini.
25+
26+
Anda dapat mendapatkan kode sumber Ruby terbaru dengan menggunakan Git.
27+
Dari *command line* Anda:
2528

2629
{% highlight sh %}
27-
$ svn co https://svn.ruby-lang.org/repos/ruby/trunk ruby
30+
$ git clone https://github.com/ruby/ruby.git
2831
{% endhighlight %}
2932

30-
Sekarang direktori `ruby` akan berisi kode sumber terbaru dari versi
31-
*development* Ruby (ruby-trunk). Saat ini *patch* yang digunakan oleh *trunk*
32-
di-*backport* ke *branch stable* {{ site.svn.stable.version }},
33-
{{ site.svn.previous.version }}, dan {{ site.svn.old.version }} (lihat bawah).
34-
35-
Jika Anda ingin *patching* Ruby {{ site.svn.stable.version }},
36-
gunakan *branch* {{ site.svn.stable.branch }} ketika sedang *checkout*:
33+
Direktori `ruby` saat ini akan berisi kode sumber terbaru dari versi
34+
*development* Ruby (ruby-trunk).
3735

38-
{% highlight sh %}
39-
$ svn co https://svn.ruby-lang.org/repos/ruby/branches/{{ site.svn.stable.branch }}
40-
{% endhighlight %}
36+
Lihat juga [Non-committer’s HOWTO to join our development][noncommitterhowto].
4137

42-
Demikian pula untuk Ruby {{ site.svn.previous.version }}:
38+
Jika Anda memiliki akses *commit*, dan jika Anda ingin *push* sesuatu,
39+
Anda seharusnya menggunakan repositori utama.
4340

4441
{% highlight sh %}
45-
$ svn co https://svn.ruby-lang.org/repos/ruby/branches/{{ site.svn.previous.branch }}
42+
$ git clone git@git.ruby-lang.org:ruby.git
4643
{% endhighlight %}
4744

48-
Perintah di atas akan melakukan *checkout* masing-masing ke direktori
49-
`{{ site.svn.stable.branch }}` or `{{ site.svn.previous.branch }}`.
50-
Pekerjaan pengembang pada *maintenance branch* diharapkan untuk migrasi
51-
perubahannya ke Ruby *trunk*, seringkali *branch-branch* kelihatan sangat
52-
mirip, dengan pengecualian ada perbaikan yang dibuat oleh Matz dan Nobu untuk
53-
bahasa Ruby sendiri.
54-
55-
Kalau Anda berminat *browsing*, Anda bisa *browse* [repository Ruby melalui
56-
web][2].
57-
58-
Untuk informasi lebih lanjut tentang Subversion, silakan lihat [the
59-
Subversion FAQ][3] dan [the Subversion book][4]. Sebagai alternatif,
60-
Anda bisa juga dapatkan buku [Pragmatic Version Control with Subversion][5]
61-
sebagai buku yang berguna untuk pengenalan svn.
62-
63-
### Bagaimana Menggunakan Git pada Repositori Utama Ruby
64-
{: #git-ruby}
65-
66-
Bagi mereka yang lebih memilih menggunakan [Git][6] dibanding Subversion dapat
67-
mengikuti instruksi di [mirror on GitHub][7], baik untuk [comitter][8]
68-
maupun [bukan commiter][9].
69-
7045
### Menyempurnakan Ruby, dengan Patch
7146
{: #patching-ruby}
7247

73-
Tim Ruby Core merawat [bug tracker][6] untuk memasukkan *patch* dan laporan
48+
Tim Ruby Core merawat [issue tracker][10] untuk memasukkan *patch* dan laporan
7449
*bug* ke Matz dan rekan-rekannya. Laporan-laporan ini juga dimasukkan ke
7550
[milis Ruby-Core][mailing-lists] untuk didiskusikan, jadi Anda bisa
7651
mengkonfirmasi terlebih dahulu apakah permintaan Anda akan diperhatikan atau
@@ -83,25 +58,22 @@ langsung dari Matz, bagaimana *patch* Anda dipertimbangkan.
8358
Sebagai ringkasan, langkah-langkah mengirimkan *patch* adalah sebagai
8459
berikut:
8560

86-
1. *Checkout* salinan kode sumber Ruby dari Subversion.
61+
1. *Check out* salinan kode sumber Ruby dari GitHub.
8762
Biasanya *patch* untuk *bugfix* atau fitur baru dimasukkan
88-
untuk *trunk* dari kode sumber Ruby. Bahkan jika Anda ingin menambahkan
89-
sebuah fitur ke Ruby {{ site.svn.previous.version }}, perubahan harus
90-
disetujui terlebih dahulu di *trunk*.
63+
untuk *trunk* dari kode sumber Ruby.
9164

92-
$ svn co https://svn.ruby-lang.org/repos/ruby/trunk ruby
65+
$ git clone https://github.com/ruby/ruby.git
9366

9467
Jika Anda sedang memperbaiki sebuah *bug* yang khusus pada satu *branch
95-
maintenance*, *checkout* salinan dari masing-masing *branch*,
96-
Misal, `{{ site.svn.previous.branch }}`.
68+
maintenance*, *check out* salinan dari masing-masing *branch*.
9769

98-
$ svn co https://svn.ruby-lang.org/repos/ruby/branches/{{ site.svn.previous.branch }}
70+
$ git checkout ruby_X_X
9971

100-
2. Tambahkan perbaikan Anda ke *source code* Ruby.
72+
2. Tambahkan perbaikan Anda ke kode.
10173

10274
3. Buat sebuah *patch*.
10375

104-
$ svn diff > ruby-changes.patch
76+
$ git diff > ruby-changes.patch
10577

10678
4. Buat sebuah tiket di [issue tracker][10] atau kirim *patch* melalui e-mail
10779
ke [Ruby-Core mailing list][mailing-lists] dengan entri ChangeLog yang
@@ -122,50 +94,43 @@ kemari. Jangan mengirimkan hal-hal di luar topik (OOT) karena milis ini
12294
adalah milis serius. Mari kita menjaga sopan santun karena kita
12395
berkorespondensi dengan pembuat Ruby.
12496

125-
Ingatlah tim Ruby Core tinggal di Jepang dan walau banyak yang
97+
Ingatlah banyak tim Ruby Core tinggal di Jepang dan walau banyak yang
12698
bisa berbicara bahasa Inggris dengan baik tetap ada perbedaan zona waktu
12799
yang jauh. Mereka juga punya milis pengembangan yang menggunakan bahasa
128100
Jepang selain dengan milis berbahasa Inggris. Jadi sabarlah, jika tidak
129101
ada yang membalas kiriman Anda; jangan menyerah dan coba lagi beberapa
130102
hari kemudian.
131103

132-
### Pedoman untuk Pengembang Inti
133-
{: #coding-standards}
134104

135-
Secara umum developer Ruby harus sudah terbiasa dengan kode sumber dan
136-
gaya pengembangan yang digunakan oleh tim Ruby Core. Supaya jelas,
137-
pedoman berikut harus dipatuhi ketika *check-in* (*commit*) ke
138-
Subversion:
105+
### Catatan terkait branches
106+
107+
Kode sumber Ruby telah dikelola menggunakan repositori Subversion hingga
108+
22 April 2019.
109+
Sehingga, beberapa *branch* mungkin masih dikelola dengan Subversion.
110+
Anda dapat melihat repositori SVN.
139111

140-
* Semua check-ins harus dijelaskan di `ChangeLog`, yang mengikuti
141-
[standar GNU][14]. (Banyak Developer Ruby Core menggunakan Emacs
142-
`add-log` mode, yang bisa diakses dengan perintah `C-x 4 a`.)
143-
* Tanggal *check-in* harus diberikan dalam format yang memenuhi standar
144-
waktu Jepang (UTC+9).
145-
* Poin-poin ChangeLog Anda harus ditaruh juga di pesan *commit*
146-
Subversion. Pesan ini secara otomatis di e-mail ke milis Ruby-CVS
147-
setelah Anda *commit*.
148-
* *Function prototype* digunakan di seluruh kode sumber Ruby dan
149-
*packaged extension*-nya.
150-
* Tolong jangan gunakan gaya komentar C++ (`//`), *maintainer* Ruby
151-
cenderung memakai komentar multibaris standar C (`/* .. */`).
112+
* [<URL:https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby>][svn-viewvc]
152113

153-
Lihat juga informasi di [Ruby’s issue tracker][10].
114+
Namun demikian, Anda tidak harus peduli tentang itu (kecuali Anda adalah
115+
seorang *branch maintainer*).
116+
Anda dapat *check out branch* pada salinan kerja Git Anda.
117+
Sebagai contoh, jalankan perintah berikut.
118+
119+
{% highlight sh %}
120+
$ git checkout ruby_X_X
121+
{% endhighlight %}
154122

123+
X_X seharusnya diganti dengan sebuah versi yang Anda ingin *check out*.
155124

125+
Jika Anda ingin memodifikasi *branch*, mohon buka sebuah isu pada [issue tracker][10] kami.
126+
Lihat juga bagian berikut.
156127

128+
[gitrlo]: https://git.ruby-lang.org/ruby.git
157129
[mailing-lists]: /en/community/mailing-lists/
158130
[writing-patches]: /en/community/ruby-core/writing-patches/
159-
[1]: http://subversion.apache.org/
160-
[2]: https://svn.ruby-lang.org/cgi-bin/viewvc.cgi/
161-
[3]: http://subversion.apache.org/faq.html
162-
[4]: http://svnbook.org
163-
[5]: http://www.pragmaticprogrammer.com/titles/svn/
164-
[6]: http://git-scm.com/
131+
[noncommitterhowto]: https://github.com/shyouhei/ruby/wiki/noncommitterhowto
132+
[svn-viewvc]: https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby
165133
[7]: https://github.com/ruby/ruby
166-
[8]: https://github.com/shyouhei/ruby/wiki/committerhowto
167-
[9]: https://github.com/shyouhei/ruby/wiki/noncommitterhowto
168134
[10]: https://bugs.ruby-lang.org/
169135
[12]: http://www.gnu.org/software/diffutils/manual/html_node/Unified-Format.html
170136
[13]: http://www.gnu.org/software/diffutils/manual/html_node/Merging-with-patch.html#Merging%20with%20patch
171-
[14]: http://www.gnu.org/prep/standards/standards.html#Change-Logs

0 commit comments

Comments
 (0)