EN: Read in English
Dunia 12: Misi Kerjaya
PR sumber terbuka pertama anda
Anda akan belajar: langkah untuk cadangkan pembetulan kepada projek orang lain.
Teks BM belum disemak oleh penutur asli.
Masalahnya
Anda suka satu aplikasi nota percuma. README-nya ada salah taip. Anda bukan ahli pasukan mereka. Bolehkah anda tetap membaikinya?
Tekan baris yang ada salah taip.
0 daripada 1 dijumpai
Cuba
Kod sumber terbuka (open source) boleh dilihat semua orang. Sesiapa pun boleh cadangkan perubahan. Penjaga projek, iaitu maintainer, tentukan apa yang masuk. Siapa buat apa?
Seret kad ke dalam kotak. Atau ketik kad, kemudian ketik kotak.
Tengok
Tekan setiap issue yang khas untuk orang baru.
0 daripada 2 dijumpai
Maintainer tanda tugasan mudah dengan label good first issue: Label untuk issue mudah yang sesuai bagi orang baru. (untuk orang baru). Mula di situ. Tulis semula kod besar boleh tunggu.
Cuba
Projek simpan peraturan rumahnya dalam CONTRIBUTING.md: Peraturan rumah untuk pembantu: cara melapor, mengubah dan menghantar kerja.. Baca yang ini. Kemudian ikut peraturan 1 dalam issue #42.
Cara menyumbang kepada QuickNotes
Terima kasih kerana membantu!
- Tanya dalam issue sebelum mula.
- Satu perubahan kecil bagi setiap pull request.
- Tulis mesej commit yang jelas, contohnya
docs: fix typo. - Berbudi bahasa. Kami semua sukarelawan.
Petunjuk
Buka Issues, kemudian #42. Tulis komen berbentuk soalan, contohnya: Boleh saya ambil yang ini?Cuba
Susun seluruh perjalanan ini. Anda dah kenal fork (salinan projek orang lain) dalam World 4. Pull request (minta perubahan diterima) pula dalam World 5.
Langkah pertama di atas. Susun ikut turutan. Guna anak panah, atau seret.
- Clone fork anda
- Buat satu perubahan kecil dan commit
- Balas semakan dengan baik
- Buat branch baru
- Push branch ke fork anda
- Buka pull request
- Fork projek ke akaun anda
Petunjuk
Anda tak boleh clone fork yang belum wujud. Dan PR datang selepas push.Cuba
Pembetulan anda dah di-commit (titik simpan) dalam branch (cabang) fix-readme-typo. Bina arahan untuk hantar ke fork anda.
Ketik kepingan ikut turutan yang betul.
Petunjuk
Selepas clone fork anda,origin ialah fork anda.Semak
Maintainer balas: “Terima kasih! Boleh baiki salah taip yang sama dalam docs/setup.md juga?” Apa anda buat?
Pilih satu jawapan.
Tengok
Ketik setiap titik pada garis masa.
Satu PR ialah permulaan yang hebat. Tekan untuk lihat laluan anda dari sini.
Anda berjaya!
Kini anda boleh cadangkan pembetulan kepada mana-mana projek sumber terbuka.
Nak tahu lebih (pilihan)
Banyak repo ada halaman contribute yang senaraikan good first issue mereka. Cuba github.com/OWNER/REPO/contribute. PR anda mungkin menunggu beberapa hari. Maintainer selalunya sukarelawan, jadi bersabar. Sesetengah projek minta anda tandatangan perjanjian penyumbang dulu. CONTRIBUTING.md akan beritahu.
English
You love a free notes app. Its README has a typo. You are not on their team. Can you still fix it?
Open source code is public. Anyone can suggest a change. The project’s keepers, called maintainers, decide what goes in. Who does what?
Maintainers mark easy tasks with a label: good first issue. Start there. Big rewrites can wait.
Projects keep their house rules in CONTRIBUTING.md. Read this one. Then follow rule 1 on issue #42.
Put the whole journey in order. You met forks in World 4 and pull requests in World 5.
Your fix is committed on a branch called fix-readme-typo. Build the command that sends it to your fork.
origin is your fork.A maintainer replies: “Thanks! Can you fix the same typo in docs/setup.md too?” What do you do?
One PR is a great start. Tap your path from here.
You can now suggest a fix to any open-source project.
Anda dah siapkan ini. Latihan lagi pun bagus!
Dokumentasi rasmi: Contributing to a project · Finding ways to contribute · Contributor guidelines (CONTRIBUTING) · git push
Anda dah belajar 25 minit. Rehat sekejap bantu otak anda.
Pecutan selesai! Fokus yang hebat. Regangkan badan seminit?