EN: Read in English
Dunia 5: Kerja Berpasukan
Tulis README yang hebat
Anda akan belajar: apa yang README hebat beritahu, dan ikut urutan apa.
Teks BM belum disemak oleh penutur asli.
Masalahnya
kuiz
benda-benda
Permainan kuiz Sam mungkin seronok. Tapi README dia cuma tulis βbenda-bendaβ. Apa benda ini? Macam mana nak main? Ramai pelawat terus pergi.
Cuba
README: Fail pintu depan sesebuah repo. Ia terangkan projek itu dan cara mula. yang hebat jawab lima soalan. Susun soalan itu ikut urutan yang baik.
Soalan pertama di atas. Susun ikut turutan. Guna anak panah, atau seret.
- Projek ini buat apa?
- Kenapa ia berguna?
- Siapa yang jaga projek ini?
- Macam mana nak mula?
- Di mana nak dapat bantuan?
Petunjuk
Mula dengan apa benda ini. Tamatkan dengan orang di sebaliknya.Cuba
Baiki README Sam. Tambah satu baris tentang fungsi permainan itu. Kemudian tambah bahagian Mula di sini, dengan satu arahan dalam backtick.
Tambah penerangan pendek, tajuk ## Mula di sini dan satu arahan dalam backtick.
Pratonton
Permainan Kuiz
0 daripada 3 matlamat siap
Petunjuk
Perlukan idea? Kuiz matematik pantas yang anda main dalam pelayar.Teka
Baris pertama mana yang paling bantu orang asing?
Pilih satu jawapan.
Semak
Tabiat README yang bagus, atau perlu baiki? Leret setiap satu.
Leret ke kanan untuk bagus, ke kiri untuk perlu baiki. Atau guna butang.
Tunjuk arahan pasang dalam blok kod
Cuba
Misi sebenar, kalau anda mahu: beri repo diari anda di GitHub README yang hebat. Kemudian semak di sini.
Semak di GitHub
- Repo diari anda ada README.mdBelum disemak
Anda berjaya!
Kini anda boleh tulis README yang mengalu-alukan orang asing.
Nak tahu lebih (pilihan)
GitHub tunjuk README dari .github/, folder atas atau docs/. Ia semak ikut urutan itu. Tambah gambar dengan teks alt, supaya semua orang tahu isinya. Guna pautan relatif macam [Bantu](CONTRIBUTING.md): ia berfungsi dalam setiap salinan repo. README profil datang dalam Dunia 12.
English
Samβs quiz game might be fun. But the README just says βstuffβ. What is it? How do you play? Most visitors leave right here.
A great README answers five questions. Put them in a good order.
Fix Samβs README. Add a line that says what the game does. Then add a Get started section with a command in backticks.
Which first line helps a stranger most?
Good README habit, or needs work? Swipe each one.
Real mission, if you like: give your diary repo on GitHub a great README. Then check it here.
You can now write a README that welcomes strangers.
Anda dah siapkan ini. Latihan lagi pun bagus!
Dokumentasi rasmi: About READMEs Β· Basic writing and formatting syntax
Anda dah belajar 25 minit. Rehat sekejap bantu otak anda.
Pecutan selesai! Fokus yang hebat. Regangkan badan seminit?