Roshanjossey
8.4 KiB
Πρώτες Συνεισφορές
 |
Επιφάνεια Εργασίας GitHub (GitHub Desktop) |
|---|
Αυτός είναι ο οδηγός μας για εμάς, τους "νερντς" του τερματικού, που θέλουμε να κάνουμε τα πάντα στο τερματικό και, χάρη στο Github-CLI, μπορούμε να το επιτύχουμε. Να θυμάστε ότι η πρώτη σας συνεισφορά πρέπει να είναι διασκεδαστική, επαναφέρουσα και κινητήριο για να συνεχίσετε!
Αυτός ο οδηγός είναι λίγο πιο προκλητικός, καθώς δεν χρησιμοποιούμε καθόλου γραφική διεπαφή, αλλά είναι πολύ διασκεδαστικός και σίγουρα μπορείτε να τον ακολουθήσετε!
Το πρώτο προαπαιτούμενο είναι να έχετε:
- Εγκατεστημένο το Git (πώς να εγκαταστήσετε το git)
- Λογαριασμό GitHub
Τώρα χρειάζεται να εγκαταστήσουμε το εργαλείο github-cli στο σύστημά μας ακολουθώντας την επίσημη τεκμηρίωση
Μετά από αυτό, πρέπει να συνδεθούμε στο CLI, οπότε εκτελέστε αυτήν την εντολή:
gh auth login
Ακολουθήστε τις οδηγίες και είμαστε έτοιμοι!
Fork αυτό το αποθετήριο
Είναι τόσο εύκολο όσο το να εκτελέσετε αυτήν την εντολή:
gh repo fork firstcontributions/first-contributions
Σημαντικό: Θα σας εμφανίσει εάν θέλετε να το κλωνοποιήσετε επίσης, επιλέξτε την επιλογή "ναι"
Δημιουργία του κλαδιού σας
Θα κάνουμε αυτό το βήμα με το git, οπότε εκτελέστε αυτήν την εντολή αντικαθιστώντας το όνομα με το όνομά σας, για παράδειγμα:
git switch -c add-john-doe
Κάντε τις απαραίτητες αλλαγές και κάντε commit τις αλλαγές σας
Τώρα μπορείτε να ανοίξετε το αρχείο Contributors.md σε έναν επεξεργαστή κειμένου και να προσθέσετε το όνομά σας. Β
άλτε το όνομά σας οπουδήποτε μεταξύ αρχής και τέλους, και στη συνέχεια αποθηκεύστε το αρχείο.
Στον φάκελο του έργου, εκτελέστε git status και θα δείτε τις αλλαγές.
Προσθέστε αυτές τις αλλαγές στο κλαδί που μόλις δημιουργήσατε χρησιμοποιώντας την εντολή git add:
git add Contributors.md
Τώρα κάντε commit αυτές τις αλλαγές χρησιμοποιώντας την εντολή git commit:
git commit -m "Προσθήκη του-ονόματός-σας στη λίστα συντελεστών"
αντικαθιστώντας το το-όνομα-σας με το όνομά σας.
Ανέβασμα των αλλαγών στο GitHub
Ανεβάστε τις αλλαγές σας χρησιμοποιώντας την εντολή git push:
git push origin -u το-όνομα-του-κλαδιού-σας
αντικαθιστώντας το το-όνομα-του-κλαδιού-σας με το όνομα του κλαδιού που δημιουργήσατε προηγουμένως.
Εάν παρατηρήσετε οποιοδήποτε σφάλμα κατά την αποστολή, κάντε κλικ εδώ:
-
Σφάλμα Πιστοποίησης
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com/<το-όνομα-χρήστη-σας>/first-contributions.git/'
Πηγαίνετε στο οδηγό του GitHub για τη δημιουργία και διαμόρφωση ενός κλειδιού SSH στον λογαριασμό σας.
Υποβολή των αλλαγών σας για αναθεώρηση
Τώρα εκτελώντας αυτήν την εντολή στον φάκελο του αποθετηρίου μας θα μας επιτρέψει να δημιουργήσουμε ένα αίτημα ενσωμάτωσης για αναθεώρηση:
gh pr create --repo firstcontributions/first-contributions
Μετά από αυτό υποβάλετε το αίτημα ενσωμάτωσης.
Μπορείτε να χρησιμοποιήσετε την εντολή gh status για να δείτε το αναφερόμενο αίτημα ενσωμάτωσης σε δράση.
Πού να πάτε από εδώ;
Συγχαρητήρια! Μόλις ολοκληρώσατε την κανονική ροή εργασίας fork -> clone -> edit -> pull request που θα συναντήσετε συχνά ως συνεισφέροντες!
Γιορτάστε τη συνεισφορά σας και μοιραστείτε τη με τους φίλους και τους ακόλουθούς σας πηγαίνοντας στην [ιστοσελίδα εφα
ρμογής](https://firstcontributions.github.io/#social-share).
Μπορείτε να εγγραφείτε στην ομάδα μας στο Slack αν χρειάζεστε βοήθεια ή έχετε οποιεσδήποτε ερωτήσεις. Εγγραφή στην ομάδα Slack.
Τώρα ας ξεκινήσουμε με τη συνεισφορά σας σε άλλα έργα. Έχουμε συγκεντρώσει μια λίστα με έργα με εύκολα ζητήματα με τα οποία μπορείτε να ξεκινήσετε. Ρίξτε μια ματιά στη λίστα των έργων στην ιστοσελίδα εφαρμογής.