rhymus

Rhymus

Proyek permainan berima open-source yang dirancang untuk pengembang baru dan kontributor pertama kali.

Berita

Pada 22 Januari, cabang master-vue sekarang siap dan siap untuk kontribusi! Anda dapat menggunakan cabang master yang ada sebagai model untuk bagaimana aplikasi VUE harus dikembangkan. Termasuk dalam proyek VUE adalah tes unit (menggunakan JEST) dan VUEX (untuk manajemen negara).

Perbaikan tambahan untuk cabang master vanilla masih diterima. React akan mengatur cabangnya sendiri beberapa waktu di bulan Februari.

Sebagai pengembang Vue profesional, saya akan sangat terlibat dengan kontribusi dan pertanyaan apa pun yang muncul mengenai cabang master-vue , jadi jangan ragu untuk meminta nasihat dan membuat PR itu!

Gameplay

Rhymus adalah game open-source yang akan menampilkan kartu dengan kalimat di atasnya. Setiap kalimat akan memiliki satu kata yang tidak masuk akal tetapi berirama dengan kata yang berhasil. Misalnya, 'Saya memiliki kabut hewan peliharaan.' -> Jawab: 'Anjing'. Pengatur waktu memberi Anda 30 detik untuk menyelesaikan sebanyak mungkin.

Desain

Proyek ini akan melalui dua fase . Yang pertama akan menjadi build awal menggunakan back-end node dan html, css, dan js front-end. Untuk bangunan pertama, tidak akan ada implementasi React/Redux.

Setelah build pertama selesai dan fitur-lengkap, dua cabang baru akan dibuat di mana proyek akan direfaktor menggunakan React and Vue .

Kontribusi

Proyek ini mulai dari awal, jadi ada banyak peluang untuk berkontribusi. Cara tercepat untuk berkontribusi adalah dengan memeriksa tab Proyek dan melihat prioritas apa yang ada . Kalau tidak, salah satu dari yang berikut ini adalah cara yang bagus untuk berkontribusi:

• Mengedit readme
• Membuat file baru untuk struktur proyek
• Merestrukturisasi proyek untuk mematuhi praktik terbaik
• Mengkode salah satu front-end atau back-end
• File uji pengkodean
• Menawarkan gaya alternatif
• Menyarankan praktik yang lebih baik untuk manajemen github (termasuk pedoman kontribusi)

Pedoman Kontribusi

Saat Anda berkontribusi, silakan gunakan pedoman berikut:

• Beri nama cabang Anda dengan cara yang mencerminkan apa yang Anda rencanakan untuk dilakukan ('implementasi kartu-scrolling')
• Berikan informasi terperinci dalam permintaan tarik Anda mengenai apa yang Anda lakukan dan mengapa itu dilakukan seperti itu
• Dalam permintaan tarik Anda, renungkan kode Anda dan sertakan komentar apakah mungkin perlu refactoring atau jika ada yang sangat sulit
• Sertakan tes dengan kontribusi Anda jika berlaku

Ini adalah proyek open-source untuk pengembang dari semua tingkat pengalaman. Tolong tunjukkan kesopanan umum dan berikan umpan balik yang konstruktif jika memungkinkan.

Panduan Lengkap untuk Pemula

Jika Anda sepenuhnya baru berkontribusi pada proyek sumber terbuka atau menggunakan GIT, ikuti panduan kecil ini untuk membuat PR pertama Anda. Perlu diingat ada banyak cara untuk menyelesaikan ini, tetapi ini dirancang untuk menjadi sangat mendasar dan mudah diikuti. Jika tidak, harap perbaiki!

1. Klik Fork di kanan atas untuk membuat salinan repositori ini.
2. Dengan asumsi Anda telah menginstal gitbash, klik kanan folder dokumen Anda (tempat Anda menyimpan folder proyek) dan buka di gitbash.
3. Ketik git clone https://[email protected]/username/rhymus .
4. Buka folder ini di IDE Anda (seperti kode Visual Studio).
5. Di terminal Anda (buka dari terminal drop-down atas di VS Code), ketik git checkout -b add-puzzle .
6. Di sebelah kiri, buka folder SRC lalu folder JS dan buka puzzle.js .
7. Ikuti pola yang Anda lihat di sana dan buat teka -teki berima baru dan simpan perubahan Anda.
8. Di terminal Anda, ketik git commit -m "added new puzzle" .
9. Di terminal Anda, ketik git remote add origin https://[email protected]/username/rhymus .
10. Di terminal Anda, ketik git push origin add-puzzle .
11. Di GitHub, buka repositori Anda dan pilih cabang Add-Puzzle .
12. Klik tombol Tarik Permintaan baru dan isi.

Selesai!

Tapi tunggu, apa yang baru saja terjadi?

1. Forking membuat salinan repositori di bawah akun GitHub Anda. 2 - 3) Menggunakan gitbash, Anda menaruh salinan repositori itu ke mesin lokal Anda di mana Anda dapat membuka dan mengedit semua file. Kloning hanya membuat salinan yang tepat dari repositori yang ditunjuk URL. 4 - 5) Anda membuka folder dan membuat cabang baru. Checkout pindah ke cabang baru, dan -B berarti akan membuat cabang baru. 6 - 7) Anda menambahkan teka -teki baru mengikuti polanya, semoga!
2. Anda melakukan penyelamatan Anda! Ini berarti Anda secara resmi disimpan dan menyiapkan perubahan Anda untuk didorong ke repositori Anda secara resmi. -M menandakan pesan yang melekat pada komit sehingga Anda dan orang lain dapat melihat apa komit itu.
3. Anda menambahkan remote! Ini adalah tempat yang akan Anda dorong secara teratur. Anda hanya akan menambahkan remote tunggal satu kali, maka Anda memberikan nama panggilan (biasanya asal) yang dapat Anda gunakan alih -alih mengetik URL panjang setiap saat.
4. Anda didorong dari simpan lokal Anda ke repositori Anda di cabang tambahan-puzzle! Komit Anda secara resmi di repositori online Anda! 11 - 12) Anda membuat permintaan tarik, yang merupakan permintaan untuk repositori asli (yang ini) untuk menerima perubahan Anda ke pangkalan!

Mungkin Anda berpikir, "Tunggu, bagaimana jika kode saya mengerikan? Atau rusak? Atau benar -benar salah?" Tidak masalah! Saat Anda membuat permintaan tarik, kode Anda akan ditinjau sebelum digabungkan ke dalam repositori resmi. Jika perlu perubahan, Anda akan menerima komentar yang menjelaskan apa, bagaimana, dan mengapa berubah! Setelah Anda melakukan perubahan, Anda dapat mendorong lagi dan secara otomatis akan memperbarui permintaan tarik Anda (jadi jangan tutup jika tidak segera disetujui). Membuat kesalahan itu persis seperti yang akan Anda pelajari.

Jika Anda merasa berani, buat lebih banyak perubahan, komit, dorongan, dan PR!

Tentang penulis

Saya seorang pengembang perangkat lunak full-stack saat ini bekerja di Tokyo, Jepang. Saya menyatukan proyek ini untuk memperkuat dan membagikan pengetahuan saya tentang pemrograman. Saya juga menawarkan program Methorship kepada pemula pemula di blok tiga bulan, jadi jangan ragu untuk memeriksa saya di LinkedIn dan hubungi saya jika Anda tertarik untuk menemukan seorang mentor.