diff --git a/docs/CODE_OF_CONDUCT-id.md b/docs/CODE_OF_CONDUCT-id.md index b31f68adb..e3cfdd833 100644 --- a/docs/CODE_OF_CONDUCT-id.md +++ b/docs/CODE_OF_CONDUCT-id.md @@ -1,48 +1,48 @@ # Kode Etik Kontributor -Sebagai kontributor dan pengelola proyek ini, kami berjanji untuk menghormati semua orang yang -berkontribusi melalui pelaporan masalah, memposting permintaan fitur, memperbarui -dokumentasi, pengajuan pull request atau patch, dan aktivitas lainnya demi kepentingan -menjaga komunitas yang terbuka dan ramah. +Sebagai kontributor dan pemelihara proyek ini, dan demi membangun komunitas yang +terbuka dan ramah, kami berjanji untuk menghormati semua orang yang +berpartisipasi melalui pelaporan masalah, mengirimkan permintaan fitur, +memperbarui dokumentasi, mengirimkan Pull Request atau patch, dan kegiatan +lainnya. -Kami berkomitmen agar partisipasi dalam proyek ini bebas dari pelecehan -pengalaman untuk semua orang, terlepas dari tingkat pengalaman, jenis kelamin, -identitas dan ekspresi, orientasi seksual, disabilitas, penampilan diri, -ukuran tubuh, ras, etnis, usia, agama, dan/ kebangsaan. +Kami bertekad membuat partisipasi dalam proyek ini menjadi pengalaman bebas +pelecehan bagi semua orang, tanpa memandang tingkat pengalaman, jenis kelamin, +identitas dan ekspresi gender, orientasi seksual, cacat, penampilan pribadi, +ukuran tubuh, ras, etnis, usia, agama, atau kewarganegaraan. Contoh perilaku partisipan yang tidak dapat diterima meliputi: * Penggunaan bahasa atau citra seksual * Serangan pribadi -* Komentar troll atau menghina +* Trolling atau komentar yang menghina/menghujat * Pelecehan publik atau pribadi -* Memublikasikan informasi pribadi orang lain, seperti fisik atau alamat elektronik, tanpa izin eksplisit +* Memublikasikan informasi pribadi orang lain, seperti alamat fisik atau elektronik, tanpa izin eksplisit * Perilaku tidak etis atau tidak profesional lainnya -Pengelola proyek memiliki hak dan tanggung jawab untuk menghapus, mengedit, atau -menolak komentar, komit, kode, suntingan wiki, masalah, dan kontribusi lainnya -yang tidak sesuai dengan Kode Etik ini, atau melarang sementara atau -secara permanen setiap kontributor untuk perilaku lain yang mereka anggap tidak pantas, -mengancam, menyinggung, atau berbahaya. +Pemelihara proyek memiliki hak dan tanggung jawab untuk menghapus, mengedit, +atau menolak komentar, commit, kode, suntingan wiki, isu, dan kontribusi lainnya +yang tidak sesuai dengan Kode Etik ini, atau untuk melarang sementara atau +permanen setiap kontributor atas perilaku lain yang dianggap tidak pantas, +mengancam, menyinggung, atau merugikan. -Dengan mengadopsi Kode Etik ini, pengelola proyek berkomitmen untuk -menerapkan prinsip-prinsip ini secara adil dan konsisten pada setiap aspek pengelolaan -proyek ini. Pengelola proyek yang tidak mengikuti atau menegakkan Kode -Perilaku dapat dihapus secara permanen dari tim proyek. +Dengan mengadopsi Kode Etik ini, pemelihara proyek berkomitmen untuk +mengaplikasikan prinsip-prinsip ini secara adil dan konsisten pada setiap aspek +pengelolaan proyek ini. Pemelihara proyek yang tidak mengikuti atau menegakkan +Kode Etik ini dapat dihapus secara permanen dari tim proyek. Kode etik ini berlaku baik di dalam ruang proyek maupun di ruang publik ketika seseorang mewakili proyek atau komunitasnya. -Contoh perilaku yang kasar, melecehkan, atau tidak dapat diterima mungkin -dilaporkan dengan menghubungi pengelola proyek di victorfelder di gmail.com. Semua -keluhan akan ditinjau dan diselidiki dan akan menghasilkan tanggapan yang -dianggap perlu dan sesuai dengan keadaan. Pengelola adalah -wajib menjaga kerahasiaan terhadap pelapor suatu -insiden. +Kejadian perilaku yang kasar, mengganggu, atau tidak dapat diterima lainnya +dapat dilaporkan dengan menghubungi pemelihara proyek di victorfelder(at)gmail.com. +Semua keluhan akan ditinjau dan diselidiki, dan akan menghasilkan tanggapan yang +dianggap perlu dan sesuai dengan keadaan. Pemelihara proyek berkewajiban untuk +menjaga kerahasiaan pelapor insiden. Kode Etik ini diadaptasi dari [Contributor Covenant][homepage], versi 1.3.0, avaible at https://contributor-covenant.org/version/1/3/0/ [homepage]: https://contributor-covenant.org -[Translations](README.md#nslations) +[Terjemahan](README.md#nslations) diff --git a/docs/CONTRIBUTING-id.md b/docs/CONTRIBUTING-id.md index 4241762b5..a3a7969ce 100644 --- a/docs/CONTRIBUTING-id.md +++ b/docs/CONTRIBUTING-id.md @@ -1,68 +1,67 @@ -*[Instruksi ini dalam bahasa lain](README.md#translations)* +*[Baca instruksi ini dalam bahasa lain](README.md#translations)* -## Perjanjian lisensi kontributor +## Perjanjian Lisensi Kontributor -Dengan kerja sama Anda, Anda menerima [lisensi](../LICENSE) dari repositori ini. +Dengan berkontribusi, Anda setuju dengan [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)) +Dengan berkontribusi, Anda setuju untuk menghormati [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. +1. "Tautan untuk mengunduh buku dengan mudah" tidak selalu merujuk pada buku yang *gratis*. Harap hanya memberikan konten yang gratis. Pastikan itu benar-benar gratis. Kami tidak menerima tautan ke halaman yang *meminta* alamat email yang valid untuk mengunduh buku, tetapi kami menyambut daftar situs yang meminta alamat email. -2. Anda tidak harus terbiasa dengan Git: Jika Anda telah menemukan sesuatu yang menarik *yang belum ada di salah satu daftar*, silakan buka [Masalah](https://github.com/EbookFoundation/free-programming-books/issues) dengan tautan yang Anda sarankan. - - Jika Anda sudah familiar dengan Git, fork repositori dan kirim Pull Request (PR). +2. Anda tidak harus terbiasa dengan Git: jika Anda menemukan sesuatu yang menarik *dan belum ada di repositori ini*, silakan buka [Isu](https://github.com/EbookFoundation/free-programming-books/issues) dengan proposal tautan Anda. + - Jika Anda sudah familiar dengan Git, fork repositori dan kirimkan Pull Request (PR) Anda. -3. Kami menyimpan 6 jenis daftar. Pastikan untuk memilih yang tepat: +3. Kami memiliki 6 jenis daftar. Pastikan untuk memilih yang tepat: - - *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 perintah dan mengevaluasi hasilnya (dengan "mengevaluasi" kami tidak bermaksud "menilai"). misalnya: [Coba Haskell](http://tryhaskell.org), [Coba GitHub](http://try.github.io). - - *Playgrounds* : are online and interactive websites, games or desktop software for learning programming. Write, compile (or run), and share code snippets. Playgrounds often allow you to fork and get your hands dirty by playing with code. + - *Buku*: PDF, HTML, ePub, halaman berdasarkan gitbook.io, repositori Git, dll. + - *Kursus*: Kursus menggambarkan materi pembelajaran yang bukan berupa buku. [Ini adalah contoh 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 Git](https://learngitbranching.js.org). + - *Playgrounds*: Situs web interaktif, permainan, atau perangkat lunak desktop untuk belajar pemrograman. Anda dapat menulis, mengkompilasi (atau menjalankan), dan membagikan potongan kode. Playgrounds seringkali memperbolehkan Anda untuk membuat salinan (fork) dan membebaskan Anda untuk bermain dengan kodenya. - *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 memungkinkan Anda mengukur kemampuan pemrograman Anda dengan menyelesaikan masalah-masalah sederhana atau kompleks, dengan atau tanpa tinjauan kode, dengan atau tanpa membandingkan hasilnya dengan pengguna lain. -4. Pastikan Anda mengikuti [Guidelines](#guidelines) dan hormati [Markdown Formatting](#formatting) dari file. +4. Pastikan Anda mengikuti [Guidelines di bawah](#guidelines) dan menghormati [Formatting Markdown](#formatting) dari setiap 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. +5. GitHub Actions akan menjalankan pengujian untuk **memastikan bahwa daftar yang Anda buat diurutkan secara alfabetis** dan **mengikuti aturan format**. **Pastikan** untuk memeriksa bahwa perubahan yang Anda buat lulus uji coba tersebut. ### 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 unggah file lainnya sebanding. -- Masukkan tautan dalam urutan abjad, as described [below](#alphabetical-order). -- 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/` +- Pastikan bahwa buku yang Anda tambahkan benar-benar gratis. Periksa dua kali jika perlu. Ini akan membantu para admin jika Anda memberikan komentar di PR mengenai alasan Anda menganggap buku tersebut gratis. +- Kami tidak menerima file yang bersumber dari Google Drive, Dropbox, Mega, Scribd, Issuu, dan platform unggah file serupa lainnya. +- Masukkan tautan Anda dalam urutan alfabetis, seperti yang dijelaskan [di bawah](#alphabetical-order). +- Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga). + - Jangan gunakan layanan hosting file (termasuk namun tidak terbatas pada tautan Dropbox dan Google Drive). +- Selalu gunakan protokol tautan `https` daripada tautan `http` -- selama keduanya berada di domain yang sama dan menyajikan konten yang sama. +- Pada domain root, hapus garis miring di akhir: `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. + - Jangan gunakan tautan penyusut (shortener) 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. - 3. *hapus* jika tidak. -- 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). -- if a resource is restored using the [*Internet Archive's Wayback Machine*](https://web.archive.org) (or similar), add the "`archived`" notation, as described [below](#archived). The best versions to use are recent and complete. -- jika alamat email atau pengaturan akun diminta sebelum pengunduhan diaktifkan, tambahkan catatan bahasa yang sesuai dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. +- Jika sebuah tautan memiliki sertifikat yang sudah kedaluwarsa/sertifikat buatan sendiri/masalah SSL lainnya: + 1. *Gantilah* dengan versi `http` jika memungkinkan (karena prosesi pengecualian / bypass bisa jadi rumit di 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 ada pilihan lain. +- Jika sebuah tautan ada dalam beberapa format, tambahkan tautan terpisah dengan catatan tentang setiap format. +- Jika sebuah sumber ada di berbagai tempat di Internet: + - Gunakan tautan dengan sumber yang paling otoritatif (artinya situs web penulis lebih baik daripada situs web penyunting, yang lebih baik daripada situs web pihak ketiga). + - Jika mereka merujuk ke edisi yang berbeda, dan Anda menganggap edisi tersebut cukup berbeda sehingga layak untuk tetap mempertahankannya, tambahkan tautan terpisah dengan catatan tentang setiap edisi (lihat [Issue #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) untuk berpartisipasi dalam diskusi tentang pemformatan). +- Utamakan komit atomik (satu komit per-penambahan/penghapusan/modifikasi) daripada komit yang lebih besar. Tidak perlu menggabungkan komit-komit Anda sebelum mengirimkan PR. (Kami tidak akan pernah menegakkan aturan ini karena ini hanya masalah kenyamanan bagi para pengelola). +- Jika buku sudah lama diterbitkan, sertakan tanggal publikasinya bersama dengan judulnya. +- Sertakan nama atau nama-nama penulis yang sesuai. Anda dapat memendekkan daftar penulis dengan "`et al.`". +- Jika buku belum selesai, dan masih dalam tahap pengerjaan, tambahkan keterangan "`dalam proses`" seperti yang dijelaskan [di bawah ini](#in_process). +- Jika suatu sumber dipulihkan menggunakan [*Internet Archive's Wayback Machine*](https://web.archive.org) (atau serupa), tambahkan keterangan "`terarsip`" seperti yang dijelaskan [di bawah](#archived). Versi terbaik untuk digunakan adalah versi terbaru dan lengkap. +- Jika alamat email atau pengaturan akun diperlukan sebelum pengunduhan, tambahkan catatan sesuai dengan bahasa yang tepat dalam tanda kurung, misalnya: `(alamat email *diminta*, tidak wajib)`. @@ -120,6 +119,7 @@ Contoh: BAIK : * [Buku yang Sangat Bagus](https://example.org/book.pdf) - Jane Roe (PDF) ``` +- Format lebih dari satu (Kami lebih suka satu tautan untuk setiap sumber. Ketika tidak ada tautan tunggal yang dapat diakses lebih mudah ke format yang berbeda, beberapa tautan lebih diutamakan. Namun, setiap tautan yang kami tambahkan akan menambah beban pemeliharaan sehingga kami mencoba menghindarinya.) - Format lebih dari satu: ```text @@ -169,17 +169,17 @@ 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. -- No emojis. +- Tidak menggunakan judul yang diciptakan. Kami mencoba menggunakan judul dari sumber daya itu sendiri; kontributor diharapkan untuk tidak membuat judul atau menggunakan judul secara editorial jika hal ini dapat dihindari. Sebuah pengecualian adalah untuk karya-karya lama; jika mereka utamanya dari minat sejarah, tahun dalam tanda kurung yang ditambahkan ke judul membantu pengguna mengetahui jika mereka menarik minat. +- Tidak menggunakan judul dengan HURUF KAPITAL. Biasanya, judul yang ditulis dengan huruf kapital awal adalah yang sesuai, tetapi jika ragu, gunakan kapitalisasi yang sesuai dari sumbernya. +- Tidak menggunakan emoji. ##### URLs -- Kami tidak mengizinkan URL yang dipersingkat. +- Kami tidak mengizinkan penggunaan URL yang disingkat. - 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 internasional harus diubah menjadi format yang benar (escaped). Biasanya, bilah peramban akan menampilkan ini dalam bentuk Unicode, namun, untuk menghindari kesalahan, harap menggunakan salin dan tempel (copy and paste). +- URL yang aman (`https`) selalu diutamakan daripada URL yang tidak aman (`http`) di tempat-tempat di mana HTTPS telah diimplementasikan. - Kami tidak menyukai URL yang mengarah ke halaman web yang tidak menghosting sumber daya yang terdaftar, melainkan menunjuk ke tempat lain. @@ -187,32 +187,40 @@ Daftar kami menyediakan kumpulan metadata minimal: judul, URL, pembuat, platform ##### Pencipta - Kami ingin menghargai pencipta sumber daya gratis jika perlu, termasuk penerjemah! -- Untuk karya terjemahan penulis asli harus dikreditkan. Kami rekomendasikan memakai [MARC relators](https://loc.gov/marc/relators/relaterm.html) untuk memberi kredit kepada pencipta selain penulis, seperti dalam contoh ini: +- Untuk karya terjemahan, penulis asli harus dikreditkan. Kami rekomendasikan menggunakan [kode relator MARC](https://loc.gov/marc/relators/relaterm.html) untuk mengkredit pencipta selain penulis, seperti dalam contoh ini: ```markdown * [A Translated Book](http://example.com/book-id.html) - John Doe, `trl.:` Mike The Translator ``` - disini, anotasi `trl.:` memakai kode MARC relator untuk "penerjemah". -- Gunakan koma `,` untuk membatasi setiap item dalam daftar penulis. + di sini, anotasi `trl.:` memakai kode relator MARC untuk "penerjemah". +- Gunakan koma `,` untuk memisahkan setiap item dalam daftar penulis. - Anda dapat mempersingkat daftar penulis dengan "`et al.`". - Kami tidak mengizinkan tautan untuk Kreator. -- Untuk karya kompilasi atau remix, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" atau "RIP Tutorial" dikreditkan sebagai "`Dikompilasi dari dokumentasi StackOverflow`" (dalam Bahasa Inggris: `Compiled from StackOverflow documentation`). +- Untuk karya kompilasi atau campuran, "pencipta" mungkin memerlukan deskripsi. Misalnya, buku "GoalKicker" atau "RIP Tutorial" dikreditkan sebagai "`Dikompilasi dari dokumentasi StackOverflow`" (dalam Bahasa Inggris: `Compiled from StackOverflow documentation`). + + + +##### Kursus dan Uji Coba dengan Batas Waktu + +- Kami tidak mencantumkan hal-hal yang perlu kami hapus dalam enam bulan. +- Jika sebuah kursus memiliki periode pendaftaran atau durasi terbatas, kami tidak akan mencantumkannya. +- Kami tidak dapat mencantumkan sumber daya yang gratis hanya untuk jangka waktu tertentu. ##### 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)*`. +- Kursus. Khususnya untuk daftar kursus kami, platform merupakan bagian penting dari deskripsi sumber daya. Hal 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 akun tertentu. Contoh platform kursus termasuk Coursera, EdX, Udacity, dan Udemy. Ketika sebuah kursus bergantung pada suatu platform, nama platform tersebut harus dicantumkan dalam tanda kurung. +- YouTube. Kami memiliki banyak kursus yang terdiri dari daftar putar YouTube. Kami tidak mencantumkan YouTube sebagai sebuah platform, kami mencoba mencantumkan kreator YouTube, yang seringkali merupakan sub-platform. +- Video YouTube. Kami biasanya tidak mengaitkan tautan ke video YouTube individu kecuali jika video tersebut berdurasi lebih dari satu jam dan disusun seperti kursus atau tutorial. Jika ini adalah kasusnya, pastikan untuk mencatatnya dalam deskripsi PR. +- Leanpub. Leanpub menyediakan buku dengan berbagai model akses. Terkadang sebuah buku bisa dibaca tanpa registrasi; terkadang sebuah buku memerlukan akun Leanpub untuk akses gratis. Mengingat kualitas buku dan campuran serta kelenturan model akses Leanpub, kami mengizinkan penulisan yang terakhir dengan catatan akses `*(Akun Leanpub atau alamat email 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. +Aturan pertama dalam menentukan daftar mana sebuah sumber daya masuk adalah melihat bagaimana sumber daya itu menggambarkan dirinya sendiri. Jika sumber daya tersebut menyebut dirinya sebagai buku, bisa jadi sumber daya tersebut adalah buku. @@ -223,14 +231,14 @@ 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 meng-host 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 +- sampel teaser dari buku +- saluran IRC atau Telegram +- Slacks atau daftar email (Slacks or mailing lists) -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. +Daftar pemrograman kompetitif kami tidak seketat pengecualian ini. Lingkup repositori ini ditentukan oleh komunitas; jika Anda ingin menyarankan perubahan atau penambahan pada lingkup, harap gunakan isu (issue) untuk memberikan saran. @@ -240,13 +248,13 @@ Kami tidak rewel tentang kebukuan. Berikut adalah beberapa atribut yang menandak - memiliki ISBN (Nomor Buku Standar Internasional) - memiliki Daftar Isi -- versi yang diunduh, terutama ePub, ditawarkan +- ada versi yang dapat diunduh, terutama ePub - memiliki edisi -- itu tidak tergantung pada konten atau video interaktif +- tidak tergantung pada video atau konten interaktif - mencoba untuk mencakup topik secara komprehensif -- itu mandiri +- bersifat mandiri -Ada banyak buku yang kami daftarkan yang tidak memiliki atribut ini; itu bisa tergantung pada konteksnya. +Ada banyak buku yang kami cantumkan yang tidak memiliki atribut-atribut ini; itu bisa tergantung pada konteks. @@ -266,13 +274,13 @@ 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)). +- Penegakan aturan format dilakukan secara otomatis melalui [GitHub Actions](https://github.com/features/actions) menggunakan [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`: +- Untuk memicu validasi URL, *lakukan commit* yang mencakup pesan commit yang berisi `check_urls=berkas_yang_akan_dicek`: ```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. -- 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". +- Anda dapat menentukan lebih dari satu berkas untuk diperiksa, dengan menggunakan spasi tunggal untuk memisahkan setiap entri. +- Jika Anda menentukan lebih dari satu berkas, hasil build didasarkan pada hasil berkas terakhir yang diperiksa. Anda harus memperhatikan bahwa Anda mungkin mendapatkan hasil build yang berhasil, jadi pastikan Anda memeriksa log pembangunan pada akhir Pull Request dengan mengklik "Show all checks" -> "Details". diff --git a/docs/HOWTO-id.md b/docs/HOWTO-id.md index 878f1b107..911ad3f18 100644 --- a/docs/HOWTO-id.md +++ b/docs/HOWTO-id.md @@ -1,14 +1,14 @@ -# How-To at a glance +# Sekilas Panduan Cara Melakukan (How-To)
-*[Baca ini dalam bahasa lain](README.md#translations)* +*[Baca halaman ini dalam bahasa lain](README.md#translations)*
**Selamat datang di `Free-Programming-Books`!** -Kami menyambut kontributor baru; bahkan untuk mereka yang membuat Pull Request (PR) pertama kali di GitHub. Jika Anda adalah salah satunya, berikut adalah beberapa sumber yang mungkin bisa membantu: +Kami sangat menyambut kontributor baru, bahkan untuk mereka yang membuat Pull Request (PR) pertamanya di GitHub. Jika Anda termasuk salah satu di antara mereka, berikut adalah sumber daya yang mungkin berguna: * [Tentang Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests) *(Dalam Bahasa Inggris)* * [Membuat sebuah pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) *(Dalam Bahasa Inggris)* @@ -18,17 +18,17 @@ Kami menyambut kontributor baru; bahkan untuk mereka yang membuat Pull Request ( * [YouTube - Kursus Kilat Markdown](https://www.youtube.com/watch?v=HUBNt18RFbo) *(Dalam Bahasa Inggris)* -Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! So... why not join our [large, growing](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) community. +Jangan ragu untuk bertanya; setiap kontributor memulainya dengan PR yang pertama. Anda bisa menjadi yang keseribu! Jadi... ayo gabung ke komunitas kami yang [besar, dan berkembang](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books).
-Click to see the growth users vs. time graphs. +Klik untuk melihat perkembangan pengguna vs. grafik waktu. -[![EbookFoundation/free-programming-books's Contributor over time Graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) +[![Grafik Kontributor EbookFoundation/free-programming-books's sepanjang masa](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorOverTime&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorOverTime&repo=ebookfoundation/free-programming-books) -[![EbookFoundation/free-programming-books's Monthly Active Contributors graph](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books) +[![Grafik Kontributor Aktif Bulanan EbookFoundation/free-programming-books's](https://contributor-overtime-api.apiseven.com/contributors-svg?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)](https://www.apiseven.com/en/contributor-graph?chart=contributorMonthlyActivity&repo=ebookfoundation/free-programming-books)
-Bahkan jika Anda seorang kontributor open source yang berpengalaman, ada hal-hal yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, ***GitHub Actions* akan menjalankan *linter*, dan sering sekali menemukan sedikit masalah dengan spasi atau abjad**. Jika Anda mendapatkan tombol hijau, semuanya siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah centang yang gagal untuk mengetahui apa yang tidak disukai linter. Perbaiki masalah dan tambahkan commit ke PR Anda. +Bahkan jika Anda adalah kontributor *open source* yang berpengalaman, ada hal-hal kecil yang mungkin membuat Anda bingung. Setelah Anda mengirimkan PR Anda, **Github Actions* akan menjalankan *linter*, yang seringkali menemukan masalah kecil seperti spasi atau pengurutan abjad**. Jika Anda melihat tombol hijau, semua sudah siap untuk ditinjau, tetapi jika tidak, klik "Detail" di bawah pengecekan yang gagal untuk mengetahui apa yang tidak disukai oleh linter, dan perbaiki masalah tersebut dengan menambahkan *commit* baru ke *branch* dari mana PR Anda dibuka, -Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk `Free-Programming-Books`, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md). ([translations](README.md#translations)) +Terakhir, jika Anda tidak yakin bahwa sumber daya yang ingin Anda tambahkan sesuai untuk `Free-Programming-Books`, bacalah panduan di [BERKONTRIBUSI](CONTRIBUTING-id.md) *([terjemahan](README.md#translations) dalam bahasa lain juga tersedia)*.