Skip to content

Commit 47bc198

Browse files
davorpareskimuludLuigiImVector
authored
docs(contributing): Merge #5816 with #5752 Indonesian translation (#6719)
* Merge #5752 Indonesian CONTRIBUTING translation Vía #6590 Vía #5762 Recovered from PR #5752 requested by @reskimulud Co-authored-by: Reski Mulud Muchamad <[email protected]> * Homogenize format & indent of code blocks - Format using fenced style. - Well indent in those placed inside list enumerations. - Simulate `Good` - `Bad` monospace double colon indent inside each one. - Examples highlighting as `text-plain`. The `md, markdown` style doesn't work very well since blocks has mixed syntax. - `check_urls` code block highlighted as `properties` style (key-value pair). Solves markdownlint rules: - MD040/fenced-code-language: Fenced code blocks should have a language specified - MD046/code-block-style: Code block style [Expected: indented; Actual: fenced] * Homogenize `check_urls=file_to_check` * use "consistent" unordered list mark and ensure 4-spaces indent .editorconfig param Solves markdownlint rules: MD004/ul-style: Unordered list style "consistent" * Move some punctuation just before any closing brackets after it * Apply headings `2-1` empty lines lint rule * Move anchor alias to inside list items there where an anchor alias `<a name="...">` is used near to each of those list items * fix missing anchor aliases specially ones about Guidelines and Formatting * Hack highlight IDE/Editors headings+HTML It apply the hack to highlight in IDE/Editors those headings with an anchor alias just before itself * Homogenize Pull Request acronym * YouTube trademark typos * filenames in monospace font * literals/markup texts in monospace font - `et al.` - File extensions `.md` - Protocols: `http`, `https`... - Notes: LeanPub, require email, StackOverflow, in process, archived trailing dots in that lines * Fix #6721 in CONTRIBUTING-id.md Co-authored-by: ImVector <[email protected]> * HTML5 anchors compilant `<a name=`>`<a id=` Co-authored-by: Reski Mulud Muchamad <[email protected]> Co-authored-by: ImVector <[email protected]>
1 parent 41e3257 commit 47bc198

File tree

1 file changed

+215
-13
lines changed

1 file changed

+215
-13
lines changed

Diff for: ‎docs/CONTRIBUTING-id.md

+215-13
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,19 @@
11
*[Instruksi ini dalam bahasa lain](README.md#translations)*
22

33

4+
<!----><a id="contributor-license-agreement"></a>
45
## Perjanjian lisensi kontributor
56

67
Dengan kerja sama Anda, Anda menerima [lisensi](../LICENSE) dari repositori ini.
78

89

10+
<!----><a id="contributor-code-of-conduct"></a>
911
## Kode Etik untuk Kontributor
1012

1113
Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDUCT-id.md) dari repositori ini. ([translations](README.md#translations))
1214

1315

16+
<!----><a id="in-a-nutshell"></a>
1417
## Versi pendek
1518

1619
1. "Tautan untuk mengunduh buku dengan mudah" tidak selalu merupakan tautan ke buku *gratis*. Harap hanya menambahkan konten gratis. Pastikan mereka gratis. Kami tidak menerima tautan ke situs yang *mengharuskan* Anda mendaftar dengan alamat email yang berfungsi untuk mengunduh buku, tetapi kami menyambut situs yang meminta alamat email.
@@ -22,31 +25,230 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU
2225

2326
- *Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repo Git, dll.
2427
- *Kursus*: Kursus menggambarkan materi pembelajaran yang tidak ada dalam bentuk buku. [Ini adalah kursus](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/).
25-
- *Tutorial interaktif*: Situs web interaktif yang memungkinkan pengguna memasukkan kode sumber atau perintah dan mengevaluasi hasilnya (dengan "mengevaluasi" kami tidak bermaksud "mengevaluasi"). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba GitHub](http://try.github.io).
28+
- *Tutorial interaktif*: Situs web interaktif yang memungkinkan pengguna memasukkan kode sumber perintah dan mengevaluasi hasilnya (dengan "mengevaluasi" kami tidak bermaksud "menilai"). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba GitHub](http://try.github.io).
2629
- *Podcast dan Screencasts*: Podcast dan Screencasts.
27-
- *Kumpulan Masalah & Pemrograman Kompetitif*: Situs web atau perangkat lunak yang memberi Anda kesempatan untuk menguji keterampilan pemrograman Anda dengan memecahkan masalah sederhana atau kompleks, dengan atau tanpa tinjauan kode dan dengan atau tanpa membandingkan kinerja dengan orang lain Pengunjung situs .
30+
- *Kumpulan Masalah & Pemrograman Kompetitif*: Situs web atau perangkat lunak yang memberi Anda kesempatan untuk menguji keterampilan pemrograman Anda dengan memecahkan masalah sederhana atau kompleks, dengan atau tanpa tinjauan kode dan dengan atau tanpa membandingkan kinerja dengan orang lain Pengunjung situs.
2831

29-
4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan [Markdown Formatting](#formatting) dari file.
32+
4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan hormati [Markdown Formatting](#formatting) dari file.
3033

3134
5. GitHub Actions akan menjalankan tes untuk memastikan bahwa **daftar diurutkan berdasarkan abjad dengan benar** dan bahwa **aturan pemformatan telah diikuti**. **Pastikan** perubahan Anda lulus tes ini.
3235

3336

37+
<!----><a id="guidelines"></a>
3438
### Pedoman
3539

3640
- Pastikan sebuah buku benar-benar gratis. Periksa kembali jika perlu. Ini membantu administrator jika Anda menjelaskan dalam PR Anda mengapa menurut Anda buku tersebut gratis.
37-
- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggahan yang sebanding.
38-
- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan buka PR.
41+
- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggah file lainnya sebanding.
42+
- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan kirimkan PR.
3943
- Selalu pilih tautan dari sumber otoritatif (yaitu, situs web penulis lebih baik daripada situs web editor, yang pada gilirannya akan lebih baik daripada situs web pihak ketiga)
40-
- tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.)
44+
- tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.).
4145
- Tautan `https` harus selalu lebih disukai daripada tautan `http` - selama tautan tersebut mengarah ke domain dan konten yang sama.
4246
- Garis miring harus dihapus pada domain root: `http://example.com` alih-alih `http://example.com/`
43-
- Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html`
44-
- jangan gunakan penyingkat url
45-
- Pilih tautan ke versi terbaru alih-alih menautkan ke versi tertentu: `http://example.com/dir/book/current/` lebih baik daripada `http://example.com/dir/book/v1.0.0/index.html`
47+
- Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html`.
48+
- jangan gunakan penyingkat URL.
49+
- Pilih tautan ke "versi terbaru" alih-alih menautkan ke "versi tertentu": `http://example.com/dir/book/current/` lebih baik daripada `http://example.com/dir/book/v1.0.0/index.html`.
4650
- Jika tautan menggunakan sertifikat yang kedaluwarsa atau ditandatangani sendiri atau memiliki masalah SSL lain:
47-
1. *ganti* dengan mitra `http` jika memungkinkan (karena mungkin sulit untuk mengizinkan pengecualian pada perangkat seluler).
51+
1. *ganti* dengan mitra `http` jika memungkinkan (karena menerima pengecualian dapat menjadi rumit pada perangkat seluler).
4852
2. *biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian.
4953
3. *hapus* jika tidak.
50-
- jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan referensi ke setiap format
51-
- jika sepotong konten tersedia di beberapa tempat di Internet
52-
- pilih tautan otoritatif
54+
- jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan catatan tentang setiap format.
55+
- jika sepotong konten tersedia di beberapa tempat di Internet.
56+
- pilih tautan otoritatif.
57+
- gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga).
58+
- jika mereka menautkan ke edisi yang berbeda dan Anda menilai edisi ini cukup berbeda sehingga layak untuk disimpan, tambahkan tautan terpisah dengan catatan tentang setiap edisi (lihat [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) untuk berkontribusi pada diskusi tentang pemformatan).
59+
- lebih suka komit atom (satu komit dengan penambahan/penghapusan/modifikasi) daripada komit yang lebih besar. Tidak perlu menekan komitmen Anda sebelum mengirimkan PR. (Kami tidak akan pernah menegakkan aturan ini karena ini hanya masalah kenyamanan bagi pengelola).
60+
- jika buku lebih tua, sertakan tanggal penerbitan dengan judul.
61+
- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "`et al.`".
62+
- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "`dalam proses`", seperti yang dijelaskan [di bawah ini](#in_process).
63+
- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`.
64+
65+
66+
<!----><a id="formatting"></a>
67+
### Pemformatan
68+
69+
- Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah!
70+
- Semua daftar dimulai dengan Indeks. Idenya adalah untuk membuat daftar dan menautkan semua bagian dan subbagian di sana. Simpan dalam urutan abjad.
71+
- Bagian menggunakan heading level 3 (`###`), dan subbagian menggunakan heading level 4 (`####`).
72+
73+
Idenya adalah untuk memiliki:
74+
75+
- `2` baris kosong antara tautan terakhir dan bagian baru.
76+
- `1` baris kosong antara heading & tautan pertama dari bagiannya.
77+
- `0` baris kosong di antara dua tautan.
78+
- `1` baris kosong di akhir setiap file `.md`.
79+
80+
Contoh:
81+
82+
```text
83+
[...]
84+
* [Contoh Buku](http://example.com/example.html)
85+
(baris kosong)
86+
(baris kosong)
87+
### Contoh
88+
(baris kosong)
89+
* [Contoh Buku Lainnya](http://example.com/book.html)
90+
* [Beberapa Buku Lain](http://example.com/other.html)
91+
```
92+
93+
- Jangan gunakan spasi diantara `]` dan `(`:
94+
95+
```text
96+
BURUK : * [Contoh Buku Lainnya] (http://example.com/book.html)
97+
BAIK : * [Contoh Buku Lainnya](http://example.com/book.html)
98+
```
99+
100+
- Jika Anda menyertakan penulis, gunakan ` - ` (tanda hubung yang dikelilingi oleh satu spasi):
101+
102+
```text
103+
BURUK : * [Contoh Buku Lainnya](http://example.com/book.html)- John Doe
104+
BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) - John Doe
105+
```
106+
107+
- Letakkan satu spasi di antara tautan dan formatnya:
108+
109+
```text
110+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)(PDF)
111+
BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) (PDF)
112+
```
113+
114+
- Penulis diletakan sebelum format file:
115+
116+
```text
117+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)- (PDF) Jane Roe
118+
BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF)
119+
```
120+
121+
- Format lebih dari satu:
122+
123+
```text
124+
BURUK : * [Contoh Buku Lainnya](http://example.com/)- John Doe (HTML)
125+
BURUK : * [Contoh Buku Lainnya](https://downloads.example.org/book.html)- John Doe (situs download)
126+
BAIK : * [Contoh Buku Lainnya](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
127+
```
128+
129+
- Cantumkan tahun penerbitan dalam judul buku lama:
130+
131+
```text
132+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.html) - Jane Roe - 1970
133+
BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe
134+
```
135+
136+
- <a id="in_process"></a>Buku dalam proses:
137+
138+
```text
139+
BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
140+
```
141+
142+
143+
<!----><a id="notes"></a>
144+
### Catatan
145+
146+
Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini.
147+
148+
149+
#### Metadata
150+
151+
Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses.
152+
153+
154+
<!----><a id="titles"></a>
155+
##### Judul
156+
157+
- Tidak ada judul yang diciptakan. Kami mencoba mengambil judul dari sumber itu sendiri; kontributor diperingatkan untuk tidak membuat judul atau menggunakannya secara editorial jika hal ini dapat dihindari. Pengecualian adalah untuk karya yang lebih tua; jika mereka terutama memiliki minat historis, satu tahun dalam tanda kurung yang ditambahkan ke judul membantu pengguna mengetahui apakah mereka menarik.
158+
- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya.
159+
160+
161+
##### URLs
162+
163+
- Kami tidak mengizinkan URL yang dipersingkat.
164+
- Kode pelacakan harus dihapus dari URL.
165+
- URL internasional harus diloloskan. Bilah peramban biasanya merender ini ke Unicode, tetapi gunakan salin dan tempel.
166+
- URL aman (`https`) selalu lebih disukai daripada url tidak aman (`http`) di mana HTTPS telah diterapkan.
167+
- Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain.
168+
169+
170+
<!----><a id="creators"></a>
171+
##### Pencipta
172+
173+
- Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah!
174+
- Untuk karya terjemahan penulis asli harus dikreditkan.
175+
- Kami tidak mengizinkan tautan untuk Kreator.
176+
- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "`Dikompilasi dari dokumentasi StackOverflow`" (dalam Bahasa Inggris: `Compiled from StackOverflow documentation`).
177+
178+
179+
<!----><a id="platforms-and-access-notes"></a>
180+
##### Platform dan Catatan Akses
181+
182+
- Kursus. Khusus untuk daftar kursus kami, platform merupakan bagian penting dari deskripsi sumber daya. Ini karena platform kursus memiliki keterjangkauan dan model akses yang berbeda. Meskipun kami biasanya tidak akan mencantumkan buku yang memerlukan pendaftaran, banyak platform kursus memiliki keterjangkauan yang tidak berfungsi tanpa semacam akun. Contoh platform kursus termasuk Coursera, EdX, Udacity , dan Udemy. Jika kursus bergantung pada platform, nama platform harus dicantumkan dalam tanda kurung.
183+
- YouTube. Kami memiliki banyak kursus yang terdiri dari daftar putar YouTube. Kami tidak mencantumkan YouTube sebagai platform, kami mencoba mencantumkan pembuat YouTube, yang seringkali merupakan sub-platform.
184+
- Video YouTube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial.
185+
- Leanpub. Leanpub menyelenggarakan buku dengan berbagai model akses. Terkadang sebuah buku dapat dibaca tanpa registrasi; terkadang sebuah buku memerlukan akun Leanpub untuk akses gratis. Mengingat kualitas buku dan campuran dan fluiditas model akses Leanpub, kami mengizinkan daftar yang terakhir dengan catatan akses `*(Akun Leanpub atau email yang valid diminta)*`.
186+
187+
188+
<!----><a id="genres"></a>
189+
#### Genre
190+
191+
Aturan pertama dalam memutuskan daftar mana yang termasuk dalam sumber daya adalah melihat bagaimana sumber daya itu menggambarkan dirinya sendiri. Jika itu menyebut dirinya sebuah buku, maka mungkin itu adalah sebuah buku.
192+
193+
194+
<!----><a id="genres-we-dont-list"></a>
195+
##### Genre yang tidak kami cantumkan
196+
197+
Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami:
198+
199+
- blog
200+
- postingan blog
201+
- artikel
202+
- situs web (kecuali yang menghosting BANYAK item yang kami daftarkan).
203+
- video yang bukan kursus atau screencasts.
204+
- bab buku
205+
- sampel penggoda dari buku
206+
- Saluran IRC atau Telegram
207+
- Celana panjang atau milis
208+
209+
Daftar pemrograman kompetitif kami tidak seketat pengecualian ini. Lingkup repo ditentukan oleh komunitas; jika Anda ingin menyarankan perubahan atau penambahan ruang lingkup, silakan gunakan masalah untuk membuat saran.
210+
211+
212+
<!----><a id="books-vs-other-stuff"></a>
213+
##### Buku vs. Barang Lainnya
214+
215+
Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku:
216+
217+
- memiliki ISBN (Nomor Buku Standar Internasional)
218+
- memiliki Daftar Isi
219+
- versi yang diunduh, terutama ePub, ditawarkan
220+
- memiliki edisi
221+
- itu tidak tergantung pada konten atau video interaktif
222+
- mencoba untuk mencakup topik secara komprehensif
223+
- itu mandiri
224+
225+
Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya.
226+
227+
228+
<!----><a id="books-vs-courses"></a>
229+
##### Buku vs. Kursus
230+
231+
Terkadang ini sulit untuk dibedakan!
232+
233+
Kursus sering kali memiliki buku teks terkait, yang akan kami daftarkan dalam daftar buku kami. Kursus memiliki kuliah, latihan, tes, catatan atau alat bantu didaktik lainnya. Sebuah kuliah atau video dengan sendirinya bukanlah sebuah kursus. Sebuah powerpoint bukanlah kursus.
234+
235+
236+
<!----><a id="interactive-tutorials-vs-other-stuff"></a>
237+
##### Tutorial Interaktif vs. Hal-hal lain
238+
239+
Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif.
240+
241+
242+
<!----><a id="automation"></a>
243+
### Otomatisasi
244+
245+
- Pemformatan penegakan aturan otomatis melalui [GitHub Actions](https://github.com/features/actions) gunakan [fpb-lint](https://github.com/vhf/free-programming-books-lint) (lihat [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)).
246+
- Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot).
247+
- Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`:
248+
249+
```properties
250+
check_urls=free-programming-books.md free-programming-books-id.md
251+
```
252+
253+
- Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri.
254+
- Jika Anda menentukan lebih dari satu file, hasil build didasarkan pada hasil file terakhir yang diperiksa. Anda harus menyadari bahwa Anda dapat melewati build hijau karena hal ini, jadi pastikan untuk memeriksa log build di akhir Pull Request dengan mengklik "Show all checks" -> "Details".

0 commit comments

Comments
 (0)