ที่เก็บนี้จะช่วยให้คุณฝึกฝนพื้นฐานของการไหลของ GitHub และวิธีการทำงานในโครงการโอเพนซอร์ส
นี่คือลิงค์ไปยังงานนำเสนอไปยัง GIT โดยทั่วไป: https://docs.google.com/presentation/d/1vfsg__2-t7xjygkfs9hfpkmaomn1je0v0h7glyiy1au/edit?usp=sharing
ขั้นตอนเหล่านี้สมมติว่าคุณได้ติดตั้ง GIT ในเครื่องแล้วคุณได้สร้างบัญชี GitHub และเพิ่มคีย์ SSH ในเครื่องของคุณลงไป
ส้อม repo นี้โดยใช้ปุ่มส้อมที่มุมขวาบน
โคลน repo ของคุณในพื้นที่ git clone [email protected]:<your-github-handle>/git-tuto.git
เพิ่มโครงการดั้งเดิมเป็น repo ที่ห่างไกล git remote add upstream https://github.com/zaccharieramzi/git-tuto.git
สร้างสาขาใหม่เพื่อเพิ่มชื่อของคุณในรายชื่อผู้ที่เข้าร่วมการสอน git checkout -b <your-name-or-pseudonym>
เพิ่มชื่อของคุณลงในไฟล์ participants.csv echo '<your-name-or-pseudonym>,n' >> participants.csv
ขั้นตอนและกระทำการเปลี่ยนแปลงของคุณ git add participants.csv && git commit -m'Added <your-name-or-pseudonym> to the participants file'
ผลักดันสาขาในพื้นที่ของคุณไปยัง repo ที่ห่างไกลของคุณ git push origin <the-name-of-your-branch>
เปิดคำขอดึงใหม่ (PR): https://github.com/zaccharieramzi/git-tuto/compare คุณมีตัวอย่าง PR ที่นี่
วนซ้ำกับข้อเสนอแนะ
เมื่อการประชาสัมพันธ์ถูกรวมเข้าด้วยกันอย่า git push origin master อัปเด git checkout master && git pull upstream master repo ในพื้นที่ของคุณ
เมื่อคุณเข้าใจวิธีการทำงานของ GitHub Flow คุณสามารถลองมีส่วนร่วมในการสอนการรวม (CI) อย่างต่อเนื่อง แต่ก่อนอื่น CI คืออะไร? CI เป็นกระบวนการที่สามารถอธิบายได้ดีที่สุดเป็นการทดสอบอย่างต่อเนื่องของรหัสเป็นชิ้นส่วนที่เพิ่มเข้ามา สิ่งนี้ทำให้แน่ใจว่าการเพิ่มใหม่ของ codebase ไม่ได้เปลี่ยนแปลงพฤติกรรมของรหัสโดยไม่คาดคิด
มีเครื่องมือมากมาย แต่เราจะใช้เฉพาะ Travis CI เท่านั้น ในการตั้งค่าคุณเพียงแค่ต้องลงทะเบียนไปยังเว็บไซต์ของพวกเขาเพิ่ม repo ของคุณในรายการที่เก็บข้อมูลที่ดูแล้วเพิ่มไฟล์ config travis ลงในโครงการของคุณ ไฟล์กำหนดค่าเทรวิสเป็นไฟล์ YAML ที่มีรายการคำแนะนำเกี่ยวกับวิธีเรียกใช้การทดสอบอย่างถูกต้อง
สิ่งนี้จะถือว่าคุณได้ทำตามขั้นตอนที่ 1-4 ของการสอน GIT
เพิ่มไฟล์ _function.py ไปยังโฟลเดอร์ฟังก์ชัน
ในไฟล์นี้เขียนฟังก์ชั่นง่าย ๆ ที่สามารถทดสอบได้ง่าย ตัวอย่างคือไฟล์ฟังก์ชั่นของฉัน ฟังก์ชั่นไม่จำเป็นต้องเกี่ยวกับตัวเลข แต่สามารถเกี่ยวกับโครงสร้างข้อมูลในตัวทั้งหมดที่ Python ให้ไว้
เพิ่มการทดสอบหน่วยที่สอดคล้องกันสำหรับฟังก์ชั่นใหม่นี้ ตัวอย่างของการทดสอบหน่วยที่สอดคล้องกันเป็นของฉัน
ทำตามขั้นตอนที่ 6-10 ของการสอน Git โดยมีข้อยกเว้นเล็กน้อยที่คุณต้องมีข้อความการกระทำที่เหมาะสมกว่า
คุณมีอิสระที่จะแนะนำการปรับปรุงทั้งในงานนำเสนอและบทช่วยสอนนี้โดยใช้ปัญหาของ repo นี้ การบริจาคที่ดีครั้งแรกอาจเป็นตัวอย่างเพื่อเพิ่มแนวทางที่มีส่วนร่วม