Repositori ini akan membantu Anda mempraktikkan dasar -dasar aliran GitHub dan cara bekerja pada proyek sumber terbuka.
Berikut adalah tautan ke presentasi ke git secara umum: https://docs.google.com/presentation/d/1vfsg__2-t7xjygkfs9hfpkmaomn1je0v0h7glyiy1au/edit ?usp=haring
Langkah -langkah ini mengasumsikan bahwa Anda telah menginstal Git secara lokal, bahwa Anda telah membuat akun GitHub, dan telah menambahkan kunci SSH lokal Anda ke dalamnya.
Garakan repo ini, menggunakan tombol fork di sudut kanan atas.
Klone repo forked Anda secara lokal. git clone [email protected]:<your-github-handle>/git-tuto.git
Tambahkan proyek asli sebagai repo yang jauh. git remote add upstream https://github.com/zaccharieramzi/git-tuto.git
Buat cabang baru untuk menambahkan nama Anda ke daftar orang yang telah berpartisipasi dalam tutorial. git checkout -b <your-name-or-pseudonym>
Tambahkan nama Anda ke file participants.csv . echo '<your-name-or-pseudonym>,n' >> participants.csv
Panggung dan melakukan perubahan Anda. git add participants.csv && git commit -m'Added <your-name-or-pseudonym> to the participants file'
Dorong cabang lokal Anda ke repo jauh Anda. git push origin <the-name-of-your-branch>
Buka Permintaan Tarik Baru (PR): https://github.com/zaccharieramzi/git-tuto/compare. Anda memiliki contoh PR di sini.
ITerate dengan umpan balik.
Setelah PR (terjepit dan) digabungkan, jangan lupa untuk memperbarui repo lokal Anda ( git checkout master && git pull upstream master ) dan repo jauh Anda ( git push origin master ).
Setelah Anda memahami cara kerja aliran GitHub, Anda dapat mencoba mengambil bagian dalam tutorial Integrasi Berkelanjutan (CI). Tapi pertama -tama, apa itu CI? CI adalah proses yang dapat digambarkan sebagai pengujian kontinu kode sebagai bagian ditambahkan ke dalamnya. Ini memastikan bahwa tambahan baru pada basis kode tidak mengubah perilaku kode secara tak terduga.
Banyak alat yang ada tetapi di sini hanya akan menggunakan Travis CI. Untuk mengaturnya, Anda hanya perlu mendaftar ke situs web mereka, menambahkan repo Anda ke daftar repositori yang ditonton, dan kemudian menambahkan file konfigurasi Travis ke proyek Anda. File konfigurasi Travis adalah file YAML yang berisi daftar instruksi tentang cara menjalankan tes dengan benar.
Ini mengasumsikan Anda telah mengambil langkah 1-4 dari tutorial git.
Tambahkan file _function.py ke folder fungsi.
Dalam file ini, tulis fungsi sederhana yang dapat dengan mudah diuji. Contohnya adalah file fungsi saya. Fungsi tidak harus tentang angka tetapi dapat tentang semua struktur data bawaan yang disediakan Python.
Tambahkan uji unit yang sesuai untuk fungsi baru ini. Contoh tes unit yang sesuai adalah milik saya.
Lakukan langkah 6-10 dari git-tutorial dengan sedikit pengecualian bahwa Anda perlu memiliki pesan komit yang lebih cocok.
Anda bebas menyarankan perbaikan baik pada presentasi dan pada tutorial ini menggunakan masalah repo ini. Kontribusi yang baik pertama mungkin misalnya untuk menambahkan pedoman yang berkontribusi.