From 1b079440ebf33fedae867cce97c6e887df88fda5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 05:59:11 +0100 Subject: [PATCH 01/15] Merge #5752 Indonesian CONTRIBUTING translation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Vía EbookFoundation/free-programming-books#6590 Vía EbookFoundation/free-programming-books#5762 Recovered from PR EbookFoundation/free-programming-books#5752 requested by @reskimulud Co-authored-by: Reski Mulud Muchamad <63949402+reski-mulud-muchamad@users.noreply.github.com> --- docs/CONTRIBUTING-id.md | 196 ++++++++++++++++++++++++++++++++++++++-- 1 file changed, 186 insertions(+), 10 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index eca8d7ead6377..c89c3f285d2bc 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -22,11 +22,11 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - *Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repo Git, dll. - *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/). - - *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). + - *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). - *Podcast dan Screencasts*: Podcast dan Screencasts. - *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 . -4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan [Markdown Formatting](#formatting) dari file. +4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan hormati [Markdown Formatting](#formatting) dari file. 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. @@ -34,19 +34,195 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU ### Pedoman - 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. -- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggahan yang sebanding. -- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan buka PR. +- Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggah file lainnya sebanding. +- Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan kirimkan PR. - 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) - tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.) - Tautan `https` harus selalu lebih disukai daripada tautan `http` - selama tautan tersebut mengarah ke domain dan konten yang sama. - Garis miring harus dihapus pada domain root: `http://example.com` alih-alih `http://example.com/` - Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html` - - jangan gunakan penyingkat url -- 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` + - jangan gunakan penyingkat URL +- 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` - Jika tautan menggunakan sertifikat yang kedaluwarsa atau ditandatangani sendiri atau memiliki masalah SSL lain: - 1. *ganti* dengan mitra `http` jika memungkinkan (karena mungkin sulit untuk mengizinkan pengecualian pada perangkat seluler). + 1. *ganti* dengan mitra `http` jika memungkinkan (karena menerima pengecualian dapat menjadi rumit pada perangkat seluler). 2. *biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian. 3. *hapus* jika tidak. -- jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan referensi ke setiap format -- jika sepotong konten tersedia di beberapa tempat di Internet - - pilih tautan otoritatif +- jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan catatan tentang setiap format. +- jika sepotong konten tersedia di beberapa tempat di Internet. + - pilih tautan otoritatif. + + gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga) + + 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.) +- 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) +- jika buku lebih tua, sertakan tanggal penerbitan dengan judul. +- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al." +- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "dalam proses", seperti yang dijelaskan [di bawah ini.](#in_process) +- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)` + + +### Pemformatan + +- Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah! +- Semua daftar dimulai dengan Indeks. Idenya adalah untuk membuat daftar dan menautkan semua bagian dan subbagian di sana. Simpan dalam urutan abjad. +- Bagian menggunakan heading level 3 (`###`), dan subbagian menggunakan heading level 4 (`####`). + +Idenya adalah untuk memiliki: + +- `2` baris kosong antara tautan terakhir dan bagian baru. +- `1` baris kosong antara heading & tautan pertama dari bagiannya. +- `0` baris kosong di antara dua tautan. +- `1` baris kosong di akhir setiap file `.md`. + +Contoh: + + [...] + * [Contoh Buku](http://example.com/example.html) + (baris kosong) + (baris kosong) + ### Contoh + (baris kosong) + * [Contoh Buku Lainnya](http://example.com/book.html) + * [Beberapa Buku Lain](http://example.com/other.html) + +- Jangan gunakan spasi diantara `]` dan `(`: + +``` +BURUK : * [Contoh Buku Lainnya] (http://example.com/book.html) +BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) +``` + +- Jika Anda menyertakan penulis, gunakan ` - ` (tanda hubung yang dikelilingi oleh satu spasi): + +``` +BURUK : * [Contoh Buku Lainnya](http://example.com/book.html)- John Doe +BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) - John Doe +``` + +- Letakkan satu spasi di antara tautan dan formatnya: + +``` +BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)(PDF) +BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) (PDF) +``` + +- Penulis diletakan sebelum format file: + +``` +BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)- (PDF) Jane Roe +BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF) +``` + +- Format lebih dari satu: + +``` +BURUK : * [Contoh Buku Lainnya](http://example.com/)- John Doe (HTML) +BURUK : * [Contoh Buku Lainnya](https://downloads.example.org/book.html)- John Doe (situs download) +BAIK : * [Contoh Buku Lainnya](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) +``` + +- Cantumkan tahun penerbitan dalam judul buku lama: + +``` +BURUK : * [Buku yang Sangat Bagus](https://example.org/book.html) - Jane Roe - 1970 +BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe +``` + + +- Buku dalam proses: + +``` +BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) +``` + +### Catatan + +Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. + +#### Metadata + +Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses. + +##### Judul + +- 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. +- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya + +##### URL + +- Kami tidak mengizinkan URL yang dipersingkat. +- Kode pelacakan harus dihapus dari URL. +- URL internasional harus diloloskan. Bilah peramban biasanya merender ini ke Unicode, tetapi gunakan salin dan tempel. +- URL aman (https) selalu lebih disukai daripada url tidak aman (http) di mana https telah diterapkan. +- Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. + +##### Pencipta + +- Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! +- Untuk karya terjemahan penulis asli harus dikreditkan. +- Kami tidak mengizinkan tautan untuk Kreator. +- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow" + +##### Platform dan Catatan Akses + +- 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. +- 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. +- Video Youtube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. +- 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)* + +#### Genre + +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. + +##### Genre yang tidak kami cantumkan + +Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: + +- blog +- postingan blog +- artikel +- situs web (kecuali yang menghosting BANYAK item yang kami daftarkan.) +- video yang bukan kursus atau screencasts. +- bab buku +- sampel penggoda dari buku +- Saluran IRC atau Telegram +- Celana panjang atau milis + +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. + + +##### Buku vs. Barang Lainnya + +Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku: + +- memiliki ISBN (Nomor Buku Standar Internasional) +- memiliki Daftar Isi +- versi yang diunduh, terutama ePub, ditawarkan +- memiliki edisi +- itu tidak tergantung pada konten atau video interaktif +- mencoba untuk mencakup topik secara komprehensif +- itu mandiri + +Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. + +##### Buku vs. Kursus + +Terkadang ini sulit untuk dibedakan! + +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. + +##### Tutorial Interaktif vs. Hal-hal lain + +Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. + + +### Otomatisasi + +- 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)) +- Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot) +- Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: + +``` +check_urls=free-programming-books.md free-programming-books-en.md +``` + +- Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri. +- 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". From b3250b8c0a11f149d302c0a4b1a3a194ed3d4ec1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 10:15:51 +0100 Subject: [PATCH 02/15] 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] --- docs/CONTRIBUTING-id.md | 80 +++++++++++++++++++++-------------------- 1 file changed, 41 insertions(+), 39 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index c89c3f285d2bc..d800745994ac0 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -74,64 +74,66 @@ Idenya adalah untuk memiliki: Contoh: - [...] - * [Contoh Buku](http://example.com/example.html) - (baris kosong) - (baris kosong) - ### Contoh - (baris kosong) - * [Contoh Buku Lainnya](http://example.com/book.html) - * [Beberapa Buku Lain](http://example.com/other.html) +```text +[...] +* [Contoh Buku](http://example.com/example.html) + (baris kosong) + (baris kosong) +### Contoh + (baris kosong) +* [Contoh Buku Lainnya](http://example.com/book.html) +* [Beberapa Buku Lain](http://example.com/other.html) +``` - Jangan gunakan spasi diantara `]` dan `(`: -``` -BURUK : * [Contoh Buku Lainnya] (http://example.com/book.html) -BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) -``` + ```text + BURUK : * [Contoh Buku Lainnya] (http://example.com/book.html) + BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) + ``` - Jika Anda menyertakan penulis, gunakan ` - ` (tanda hubung yang dikelilingi oleh satu spasi): -``` -BURUK : * [Contoh Buku Lainnya](http://example.com/book.html)- John Doe -BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) - John Doe -``` + ```text + BURUK : * [Contoh Buku Lainnya](http://example.com/book.html)- John Doe + BAIK : * [Contoh Buku Lainnya](http://example.com/book.html) - John Doe + ``` - Letakkan satu spasi di antara tautan dan formatnya: -``` -BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)(PDF) -BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) (PDF) -``` + ```text + BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)(PDF) + BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) (PDF) + ``` - Penulis diletakan sebelum format file: -``` -BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)- (PDF) Jane Roe -BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF) -``` + ```text + BURUK : * [Buku yang Sangat Bagus](https://example.org/book.pdf)- (PDF) Jane Roe + BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF) + ``` - Format lebih dari satu: -``` -BURUK : * [Contoh Buku Lainnya](http://example.com/)- John Doe (HTML) -BURUK : * [Contoh Buku Lainnya](https://downloads.example.org/book.html)- John Doe (situs download) -BAIK : * [Contoh Buku Lainnya](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) -``` + ```text + BURUK : * [Contoh Buku Lainnya](http://example.com/)- John Doe (HTML) + BURUK : * [Contoh Buku Lainnya](https://downloads.example.org/book.html)- John Doe (situs download) + BAIK : * [Contoh Buku Lainnya](http://example.com/) - John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` - Cantumkan tahun penerbitan dalam judul buku lama: -``` -BURUK : * [Buku yang Sangat Bagus](https://example.org/book.html) - Jane Roe - 1970 -BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe -``` + ```text + BURUK : * [Buku yang Sangat Bagus](https://example.org/book.html) - Jane Roe - 1970 + BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe + ``` - Buku dalam proses: -``` -BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) -``` + ```text + BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) + ``` ### Catatan @@ -220,9 +222,9 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int - Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot) - Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: -``` -check_urls=free-programming-books.md free-programming-books-en.md -``` + ```text + check_urls=free-programming-books.md free-programming-books-en.md + ``` - Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri. - 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". From 7ea940ff5f41689451e3a08c34bd5b54541f6b0f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 10:16:58 +0100 Subject: [PATCH 03/15] Homogenize `check_urls=file_to_check` --- docs/CONTRIBUTING-id.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index d800745994ac0..7b970385e3d80 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -222,8 +222,8 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int - Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot) - Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: - ```text - check_urls=free-programming-books.md free-programming-books-en.md + ```properties + check_urls=free-programming-books.md free-programming-books-id.md ``` - Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri. From 9d9b155cc2587775eab3f564762e4f45f4a5b962 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:28:10 +0100 Subject: [PATCH 04/15] use "consistent" unordered list mark and ensure 4-spaces indent .editorconfig param Solves markdownlint rules: MD004/ul-style: Unordered list style "consistent" --- docs/CONTRIBUTING-id.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 7b970385e3d80..dcdc530f9bfa5 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -50,8 +50,8 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan catatan tentang setiap format. - jika sepotong konten tersedia di beberapa tempat di Internet. - pilih tautan otoritatif. - + gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga) - + 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.) + - gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga) + - 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.) - 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) - jika buku lebih tua, sertakan tanggal penerbitan dengan judul. - sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al." From 77dbcae9cafee83320fdd6676a5e3648534850e6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:37:10 +0100 Subject: [PATCH 05/15] Move some punctuation just before any closing brackets after it --- docs/CONTRIBUTING-id.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index dcdc530f9bfa5..0ce94370bceb6 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -24,7 +24,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - *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/). - *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). - *Podcast dan Screencasts*: Podcast dan Screencasts. - - *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 . + - *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. 4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan hormati [Markdown Formatting](#formatting) dari file. @@ -37,12 +37,12 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - Kami tidak merekam file yang ada di Google Drive, Dropbox, Mega, Scribd, Issuu atau platform unggah file lainnya sebanding. - Masukkan tautan dalam urutan abjad. Jika Anda menemukan tautan yang salah dimasukkan, harap perbaiki pesanan dan kirimkan PR. - 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) - - tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.) + - tidak ada platform hosting file (termasuk tautan ke Dropbox, Google Drive, dll.). - Tautan `https` harus selalu lebih disukai daripada tautan `http` - selama tautan tersebut mengarah ke domain dan konten yang sama. - Garis miring harus dihapus pada domain root: `http://example.com` alih-alih `http://example.com/` -- Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html` - - jangan gunakan penyingkat URL -- 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` +- Selalu pilih tautan terpendek: `http://example.com/dir/` lebih baik daripada `http://example.com/dir/index.html`. + - jangan gunakan penyingkat URL. +- 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`. - Jika tautan menggunakan sertifikat yang kedaluwarsa atau ditandatangani sendiri atau memiliki masalah SSL lain: 1. *ganti* dengan mitra `http` jika memungkinkan (karena menerima pengecualian dapat menjadi rumit pada perangkat seluler). 2. *biarkan apa adanya* jika versi `http` tidak tersedia, tetapi tautan dapat diakses melalui `https` dengan mengabaikan peringatan di browser atau menambahkan pengecualian. @@ -50,13 +50,13 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - jika ada tautan dalam format yang berbeda, tambahkan tautan terpisah dengan catatan tentang setiap format. - jika sepotong konten tersedia di beberapa tempat di Internet. - pilih tautan otoritatif. - - gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga) - - 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.) -- 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) + - gunakan tautan dengan sumber paling otoritatif (artinya situs web penulis lebih baik daripada situs web editor lebih baik daripada situs web pihak ketiga). + - 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). +- 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). - jika buku lebih tua, sertakan tanggal penerbitan dengan judul. -- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al." -- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "dalam proses", seperti yang dijelaskan [di bawah ini.](#in_process) -- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)` +- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al.". +- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "dalam proses", seperti yang dijelaskan [di bawah ini](#in_process). +- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. ### Pemformatan @@ -146,7 +146,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform ##### Judul - 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. -- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya +- Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya. ##### URL @@ -161,14 +161,14 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! - Untuk karya terjemahan penulis asli harus dikreditkan. - Kami tidak mengizinkan tautan untuk Kreator. -- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow" +- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow". ##### Platform dan Catatan Akses - 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. - 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. - Video Youtube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. -- 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)* +- 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)*. #### Genre @@ -181,7 +181,7 @@ Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: - blog - postingan blog - artikel -- situs web (kecuali yang menghosting BANYAK item yang kami daftarkan.) +- situs web (kecuali yang menghosting BANYAK item yang kami daftarkan). - video yang bukan kursus atau screencasts. - bab buku - sampel penggoda dari buku @@ -218,8 +218,8 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int ### Otomatisasi -- 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)) -- Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot) +- 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)). +- Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot). - Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: ```properties From 2625005e05e4c61b9178674e163d6c9614e25600 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:41:06 +0100 Subject: [PATCH 06/15] Apply headings `2-1` empty lines lint rule --- docs/CONTRIBUTING-id.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 0ce94370bceb6..52884fccd4f63 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -135,19 +135,23 @@ Contoh: BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) ``` + ### Catatan Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. + #### Metadata Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses. + ##### Judul - 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. - Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya. + ##### URL - Kami tidak mengizinkan URL yang dipersingkat. @@ -156,6 +160,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - URL aman (https) selalu lebih disukai daripada url tidak aman (http) di mana https telah diterapkan. - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. + ##### Pencipta - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! @@ -163,6 +168,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami tidak mengizinkan tautan untuk Kreator. - Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow". + ##### Platform dan Catatan Akses - 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. @@ -170,10 +176,12 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Video Youtube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. - 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)*. + #### Genre 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. + ##### Genre yang tidak kami cantumkan Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: @@ -205,12 +213,14 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. + ##### Buku vs. Kursus Terkadang ini sulit untuk dibedakan! 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. + ##### Tutorial Interaktif vs. Hal-hal lain Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. From 2f72a70b3c7ef55e8f756a8c000649b1c15d0d69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:47:58 +0100 Subject: [PATCH 07/15] Move anchor alias to inside list items there where an anchor alias `` is used near to each of those list items --- docs/CONTRIBUTING-id.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 52884fccd4f63..29a61941642c1 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -128,8 +128,7 @@ Contoh: BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe ``` - -- Buku dalam proses: +- Buku dalam proses: ```text BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) From ec2e2c7ca50c6b49b9893a6ace312ae662501ebd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:55:49 +0100 Subject: [PATCH 08/15] fix missing anchor aliases specially ones about Guidelines and Formatting --- docs/CONTRIBUTING-id.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 29a61941642c1..417526a557726 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -1,16 +1,19 @@ *[Instruksi ini dalam bahasa lain](../README.md#translations)* + ## Perjanjian lisensi kontributor Dengan kerja sama Anda, Anda menerima [lisensi](../LICENSE) dari repositori ini. + ## Kode Etik untuk Kontributor Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDUCT-id.md) dari repositori ini. ([translations](../README.md#translations)) + ## Versi pendek 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. @@ -31,6 +34,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU 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. + ### Pedoman - 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. @@ -59,6 +63,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. + ### Pemformatan - Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah! @@ -135,6 +140,7 @@ Contoh: ``` + ### Catatan Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. @@ -145,13 +151,14 @@ Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses. + ##### Judul - 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. - Tidak ada judul SEMUANYA KAPITAL. Biasanya judul kasus sesuai, tetapi jika ragu gunakan kapitalisasi dari sumbernya. -##### URL +##### URLs - Kami tidak mengizinkan URL yang dipersingkat. - Kode pelacakan harus dihapus dari URL. @@ -160,6 +167,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. + ##### Pencipta - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! @@ -168,6 +176,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow". + ##### Platform dan Catatan Akses - 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. @@ -176,11 +185,13 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - 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)*. + #### Genre 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. + ##### Genre yang tidak kami cantumkan Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: @@ -198,6 +209,7 @@ Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: 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. + ##### Buku vs. Barang Lainnya Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku: @@ -213,6 +225,7 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. + ##### Buku vs. Kursus Terkadang ini sulit untuk dibedakan! @@ -220,11 +233,13 @@ Terkadang ini sulit untuk dibedakan! 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. + ##### Tutorial Interaktif vs. Hal-hal lain Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. + ### Otomatisasi - 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)). From cd517c1fc55b3fb51286959613036df09f2f4b3e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 15:58:56 +0100 Subject: [PATCH 09/15] Hack highlight IDE/Editors headings+HTML It apply the hack to highlight in IDE/Editors those headings with an anchor alias just before itself --- docs/CONTRIBUTING-id.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 417526a557726..21f5ffa2f6cd0 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -1,19 +1,19 @@ *[Instruksi ini dalam bahasa lain](../README.md#translations)* - + ## Perjanjian lisensi kontributor Dengan kerja sama Anda, Anda menerima [lisensi](../LICENSE) dari repositori ini. - + ## Kode Etik untuk Kontributor Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDUCT-id.md) dari repositori ini. ([translations](../README.md#translations)) - + ## Versi pendek 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. @@ -34,7 +34,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU 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. - + ### Pedoman - 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. @@ -63,7 +63,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. - + ### Pemformatan - Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah! @@ -140,7 +140,7 @@ Contoh: ``` - + ### Catatan Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. @@ -151,7 +151,7 @@ Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses. - + ##### Judul - 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. @@ -167,7 +167,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. - + ##### Pencipta - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! @@ -176,7 +176,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow". - + ##### Platform dan Catatan Akses - 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. @@ -185,13 +185,13 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - 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)*. - + #### Genre 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. - + ##### Genre yang tidak kami cantumkan Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: @@ -209,7 +209,7 @@ Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: 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. - + ##### Buku vs. Barang Lainnya Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku: @@ -225,7 +225,7 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. - + ##### Buku vs. Kursus Terkadang ini sulit untuk dibedakan! @@ -233,13 +233,13 @@ Terkadang ini sulit untuk dibedakan! 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. - + ##### Tutorial Interaktif vs. Hal-hal lain Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. - + ### Otomatisasi - 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)). From e7170145af5f3aac21c3f6db82f55e03d84ba7a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 16:01:50 +0100 Subject: [PATCH 10/15] Homogenize Pull Request acronym --- docs/CONTRIBUTING-id.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 21f5ffa2f6cd0..529b493a3efdd 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -251,4 +251,4 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int ``` - Anda dapat menentukan lebih dari satu file untuk diperiksa, menggunakan satu spasi untuk memisahkan setiap entri. -- 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". +- 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". From 0baaf54fa8147a2353833cd90c754bba463365c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 16:04:51 +0100 Subject: [PATCH 11/15] YouTube trademark typos --- docs/CONTRIBUTING-id.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 529b493a3efdd..b71a132e29278 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -180,8 +180,8 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform ##### Platform dan Catatan Akses - 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. -- 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. -- Video Youtube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. +- 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. +- Video YouTube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. - 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)*. From e61cdb6d8debe8049f9c56bc835d8fd48fc15091 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 16:06:56 +0100 Subject: [PATCH 12/15] filenames in monospace font --- docs/CONTRIBUTING-id.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index b71a132e29278..b9052c4faabe7 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -242,7 +242,7 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int ### Otomatisasi -- 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)). +- 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)). - Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot). - Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: From f35b8c3301525c28e74b1460234b5d9f9b1e49fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= Date: Sun, 13 Feb 2022 16:21:44 +0100 Subject: [PATCH 13/15] 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 --- docs/CONTRIBUTING-id.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index b9052c4faabe7..08571c2da0b78 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -58,8 +58,8 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - 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). - 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). - jika buku lebih tua, sertakan tanggal penerbitan dengan judul. -- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "et al.". -- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "dalam proses", seperti yang dijelaskan [di bawah ini](#in_process). +- sertakan nama penulis atau nama yang sesuai. Anda dapat mempersingkat daftar penulis dengan "`et al.`". +- jika buku belum selesai, dan masih dalam pengerjaan, tambahkan notasi "`dalam proses`", seperti yang dijelaskan [di bawah ini](#in_process). - jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. @@ -163,7 +163,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami tidak mengizinkan URL yang dipersingkat. - Kode pelacakan harus dihapus dari URL. - URL internasional harus diloloskan. Bilah peramban biasanya merender ini ke Unicode, tetapi gunakan salin dan tempel. -- URL aman (https) selalu lebih disukai daripada url tidak aman (http) di mana https telah diterapkan. +- URL aman (`https`) selalu lebih disukai daripada url tidak aman (`http`) di mana HTTPS telah diterapkan. - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. @@ -173,7 +173,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! - Untuk karya terjemahan penulis asli harus dikreditkan. - Kami tidak mengizinkan tautan untuk Kreator. -- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" dikreditkan sebagai "Dikompilasi dari dokumentasi StackOverflow". +- 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`). @@ -182,7 +182,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - 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. - 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. - Video YouTube. Kami biasanya tidak menautkan ke video YouTube individu kecuali jika durasinya lebih dari satu jam dan terstruktur seperti kursus atau tutorial. -- 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)*. +- 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)*`. From ad87207314e4f339689cc70d06fbf35cae23fb77 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Sun, 13 Feb 2022 20:16:48 +0100 Subject: [PATCH 14/15] Fix #6721 in CONTRIBUTING-id.md Co-authored-by: ImVector <59611597+LuigiImVector@users.noreply.github.com> --- docs/CONTRIBUTING-id.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 4fb1d3c11d2ac..01c905e4b7b26 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -242,7 +242,7 @@ Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Int ### Otomatisasi -- 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)). +- 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)). - Validasi URL menggunakan [awesome_bot](https://github.com/dkhamsing/awesome_bot). - Untuk memicu validasi URL, *push commit* yang menyertakan pesan komit yang berisi `check_urls=file_to_check`: From 846fbfa49f21f62c66c912dca0ca1242e6818976 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20Ord=C3=A1s?= <3125580+davorpa@users.noreply.github.com> Date: Tue, 22 Feb 2022 05:31:47 +0100 Subject: [PATCH 15/15] HTML5 anchors compilant `` + ## Perjanjian lisensi kontributor Dengan kerja sama Anda, Anda menerima [lisensi](../LICENSE) dari repositori ini. - + ## Kode Etik untuk Kontributor Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDUCT-id.md) dari repositori ini. ([translations](README.md#translations)) - + ## Versi pendek 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. @@ -34,7 +34,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU 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. - + ### Pedoman - 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. @@ -63,7 +63,7 @@ Dengan partisipasi Anda, Anda berjanji untuk mengikuti [Kode Etik](CODE_OF_CONDU - jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. - + ### Pemformatan - Semua daftar adalah file `.md`. Coba pelajari sintaks [Markdown](https://guides.github.com/features/mastering-markdown/). Itu mudah! @@ -133,14 +133,14 @@ Contoh: BAIK : * [Buku yang Sangat Bagus (1970)](https://example.org/book.html) - Jane Roe ``` -- Buku dalam proses: +- Buku dalam proses: ```text BAIK : * [Akan Segera Menjadi Buku yang Luar Biasa](http://example.com/book2.html) - John Doe (HTML) (:construction: *in process*) ``` - + ### Catatan Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya yang kami daftarkan. Berikut adalah beberapa catatan tentang bagaimana kita menghadapi keragaman ini. @@ -151,7 +151,7 @@ Meskipun dasar-dasarnya relatif sederhana, ada keragaman besar dalam sumber daya Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform, dan catatan akses. - + ##### Judul - 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. @@ -167,7 +167,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. - + ##### Pencipta - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! @@ -176,7 +176,7 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - 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`). - + ##### Platform dan Catatan Akses - 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. @@ -185,13 +185,13 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform - 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)*`. - + #### Genre 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. - + ##### Genre yang tidak kami cantumkan Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: @@ -209,7 +209,7 @@ Karena Internet sangat luas, kami tidak memasukkan dalam daftar kami: 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. - + ##### Buku vs. Barang Lainnya Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandakan bahwa sumber daya adalah sebuah buku: @@ -225,7 +225,7 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. - + ##### Buku vs. Kursus Terkadang ini sulit untuk dibedakan! @@ -233,13 +233,13 @@ Terkadang ini sulit untuk dibedakan! 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. - + ##### Tutorial Interaktif vs. Hal-hal lain Jika Anda dapat mencetaknya dan mempertahankan esensinya, itu bukan Tutorial Interaktif. - + ### Otomatisasi - 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)).