You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/CONTRIBUTING-id.md
+186-10
Original file line number
Diff line number
Diff line change
@@ -22,31 +22,207 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU
22
22
23
23
-*Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repo Git, dll.
24
24
-*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).
25
+
-*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).
26
26
-*Podcast dan Screencasts*: Podcast dan Screencasts.
27
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 .
28
28
29
-
4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan [Markdown Formatting](#formatting) dari file.
29
+
4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan hormati [Markdown Formatting](#formatting) dari file.
30
30
31
31
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.
32
32
33
33
34
34
### Pedoman
35
35
36
36
- 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.
37
+
- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggah file lainnya sebanding.
38
+
- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan kirimkan PR.
39
39
- 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
40
- tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.)
41
41
- Tautan `https` harus selalu lebih disukai daripada tautan `http` - selama tautan tersebut mengarah ke domain dan konten yang sama.
42
42
- Garis miring harus dihapus pada domain root: `http://example.com` alih-alih `http://example.com/`
43
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`
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`
46
46
- 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).
47
+
1.*ganti* dengan mitra `http` jika memungkinkan (karena menerima pengecualian dapat menjadi rumit pada perangkat seluler).
48
48
2.*biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian.
49
49
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
50
+
- jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan catatan tentang setiap format.
51
+
- jika sepotong konten tersedia di beberapa tempat di Internet.
52
+
- pilih tautan otoritatif.
53
+
+ gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga)
54
+
+ 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.)
55
+
- 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)
56
+
- jika buku lebih tua, sertakan tanggal penerbitan dengan judul.
57
+
- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al."
58
+
- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "dalam proses", seperti yang dijelaskan [di bawah ini.](#in_process)
59
+
- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`
60
+
61
+
62
+
### Pemformatan
63
+
64
+
- Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah!
65
+
- Semua daftar dimulai dengan Indeks. Idenya adalah untuk membuat daftar dan menautkan semua bagian dan subbagian di sana. Simpan dalam urutan abjad.
66
+
- Bagian menggunakan heading level 3 (`###`), dan subbagian menggunakan heading level 4 (`####`).
67
+
68
+
Idenya adalah untuk memiliki:
69
+
70
+
-`2` baris kosong antara tautan terakhir dan bagian baru.
71
+
-`1` baris kosong antara heading & tautan pertama dari bagiannya.
72
+
-`0` baris kosong di antara dua tautan.
73
+
-`1` baris kosong di akhir setiap file `.md`.
74
+
75
+
Contoh:
76
+
77
+
[...]
78
+
* [Contoh Buku](http://example.com/example.html)
79
+
(baris kosong)
80
+
(baris kosong)
81
+
### Contoh
82
+
(baris kosong)
83
+
* [Contoh Buku Lainnya](http://example.com/book.html)
84
+
* [Beberapa Buku Lain](http://example.com/other.html)
85
+
86
+
- Jangan gunakan spasi diantara `]` dan `(`:
87
+
88
+
```
89
+
BURUK : * [Contoh Buku Lainnya] (http://example.com/book.html)
90
+
BAIK : * [Contoh Buku Lainnya](http://example.com/book.html)
91
+
```
92
+
93
+
- Jika Anda menyertakan penulis, gunakan ` - ` (tanda hubung yang dikelilingi oleh satu spasi):
94
+
95
+
```
96
+
BURUK : * [Contoh Buku Lainnya](http://example.com/book.html)- John Doe
97
+
BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) - John Doe
98
+
```
99
+
100
+
- Letakkan satu spasi di antara tautan dan formatnya:
101
+
102
+
```
103
+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)(PDF)
104
+
BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) (PDF)
105
+
```
106
+
107
+
- Penulis diletakan sebelum format file:
108
+
109
+
```
110
+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)- (PDF) Jane Roe
111
+
BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF)
112
+
```
113
+
114
+
- Format lebih dari satu:
115
+
116
+
```
117
+
BURUK : * [Contoh Buku Lainnya](http://example.com/)- John Doe (HTML)
118
+
BURUK : * [Contoh Buku Lainnya](https://downloads.example.org/book.html)- John Doe (situs download)
119
+
BAIK : * [Contoh Buku Lainnya](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html)
120
+
```
121
+
122
+
- Cantumkan tahun penerbitan dalam judul buku lama:
123
+
124
+
```
125
+
BURUK : * [Buku yang Sangat Bagus](https://example.org/book.html) - Jane Roe - 1970
126
+
BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe
127
+
```
128
+
129
+
<aname="in_process"></a>
130
+
- Buku dalam proses:
131
+
132
+
```
133
+
BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*)
134
+
```
135
+
136
+
### Catatan
137
+
138
+
Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini.
139
+
140
+
#### Metadata
141
+
142
+
Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses.
143
+
144
+
##### Judul
145
+
146
+
- 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.
147
+
- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya
148
+
149
+
##### URL
150
+
151
+
- Kami tidak mengizinkan URL yang dipersingkat.
152
+
- Kode pelacakan harus dihapus dari URL.
153
+
- URL internasional harus diloloskan. Bilah peramban biasanya merender ini ke Unicode, tetapi gunakan salin dan tempel.
154
+
- URL aman (https) selalu lebih disukai daripada url tidak aman (http) di mana https telah diterapkan.
155
+
- Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain.
156
+
157
+
##### Pencipta
158
+
159
+
- Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah!
160
+
- Untuk karya terjemahan penulis asli harus dikreditkan.
161
+
- Kami tidak mengizinkan tautan untuk Kreator.
162
+
- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow"
163
+
164
+
##### Platform dan Catatan Akses
165
+
166
+
- 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.
167
+
- 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.
168
+
- Video Youtube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial.
169
+
- 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)*
170
+
171
+
#### Genre
172
+
173
+
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.
174
+
175
+
##### Genre yang tidak kami cantumkan
176
+
177
+
Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami:
178
+
179
+
- blog
180
+
- postingan blog
181
+
- artikel
182
+
- situs web (kecuali yang menghosting BANYAK item yang kami daftarkan.)
183
+
- video yang bukan kursus atau screencasts.
184
+
- bab buku
185
+
- sampel penggoda dari buku
186
+
- Saluran IRC atau Telegram
187
+
- Celana panjang atau milis
188
+
189
+
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.
190
+
191
+
192
+
##### Buku vs. Barang Lainnya
193
+
194
+
Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku:
195
+
196
+
- memiliki ISBN (Nomor Buku Standar Internasional)
197
+
- memiliki Daftar Isi
198
+
- versi yang diunduh, terutama ePub, ditawarkan
199
+
- memiliki edisi
200
+
- itu tidak tergantung pada konten atau video interaktif
201
+
- mencoba untuk mencakup topik secara komprehensif
202
+
- itu mandiri
203
+
204
+
Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya.
205
+
206
+
##### Buku vs. Kursus
207
+
208
+
Terkadang ini sulit untuk dibedakan!
209
+
210
+
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.
211
+
212
+
##### Tutorial Interaktif vs. Hal-hal lain
213
+
214
+
Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif.
- Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri.
228
+
- 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