free-programming-books/docs/CONTRIBUTING-id.md
Eric Hellman 868d94730a
move the translated documentation files to a docs folder ()
* new branch for misc cleanup

* add item to resolve 

* fix grammar

* re-collate

* centralize all the translation links

* one more

* fix link

* localize labels

* move files

* fix links

* indent in arabic

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* typos

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* remove

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translation

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translation

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* mixed markdown

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* period

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* missing *

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* Update docs/HOWTO-pl.md

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* Update docs/HOWTO-th.md

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translated

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translate

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* lower case

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* typo

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* wording

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translations link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* space

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* space

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* typo

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* Update CONTRIBUTING-de.md

* space

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* parens not brackets

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* add 

* chore: resolve dead code CONTRIB-es

Addressed at https://github.com/EbookFoundation/free-programming-books/pull/6614#commitcomment-60517997

Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277

* chore: use spanish translated text for "translations"

Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277

* chore: DRY. Use markdown link refs as translations target

Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277

* fix: revert removed parens in previous commit 6276a21d85

Review suggestion: https://github.com/EbookFoundation/free-programming-books/pull/6614#discussion_r751697277

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* lint

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* lint

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* lint

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* lint

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* fix link

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* space

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

* translate

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>

Co-authored-by: David Ordás <3125580+davorpa@users.noreply.github.com>
2021-11-20 13:25:15 -05:00

4.2 KiB

Instruksi ini dalam bahasa lain

Perjanjian lisensi kontributor

Dengan kerja sama Anda, Anda menerima lisensi dari repositori ini.

Kode Etik untuk Kontributor

Dengan partisipasi Anda, Anda berjanji untuk mengikuti Kode Etik dari repositori ini. (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.

  2. Anda tidak harus terbiasa dengan Git: Jika Anda telah menemukan sesuatu yang menarik yang belum ada di salah satu daftar, silakan buka Masalah dengan tautan yang Anda sarankan.

    • Jika Anda sudah familiar dengan Git, fork repositori dan kirim pull request.
  3. Kami menyimpan 5 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.
    • 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, Coba Github.
    • 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 dan Markdown 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.

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.
  • 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
  • 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).
    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