Roshanjossey
11 KiB
Πρώτες Συνεισφορές
 |
Έκδοση GitKraken |
|---|
Είναι δύσκολο. Είναι πάντα δύσκολο, όταν κάνετε κάτι για πρώτη φορά. Ειδικά όταν συνεργάζεστε, το να κάνεις κάποιο λάθος δεν είναι κάτι άνετο. Αλλά ο ανοιχτός κώδικας αφορά τη συνεργασία και τη συνεργασία. Θέλαμε να απλοποιήσουμε τον τρόπο με τον οποίο νέοι συνεισφέροντες ανοιχτού κώδικα μαθαίνουν και συνεισφέρουν για πρώτη φορά.
Η ανάγνωση άρθρων και η παρακολούθηση εκπαιδευτικού υλικού μπορεί να βοηθήσει, αλλά τι είναι καλύτερο από το να κάνετε όντως κάτι χωρίς να χαλάσετε τίποτα. Αυτό το έργο έχει σκοπό να παρέχει καθοδήγηση και να απλοποίησει τον τρόπο με τον οποίο οι νέοι συνεισφέροντες μπορούν να κάνουν την πρώτη τους συνεισφορά. Θυμηθείτε, όσο πιο χαλαροί είστε, τόσο καλύτερα μαθαίνετε. Εάν θέλετε να κάνετε την πρώτη σας συνεισφορά, ακολουθήστε απλά τα απλά βήματα παρακάτω. Σας υποσχόμαστε, θα είναι διασκεδαστικό.
GitKraken
Κατεβάστε το GitKraken, εγκαταστήστε το και ανοίξτε το.
Θα δείτε το παράθυρο "Καλώς ήρθατε στο GitKraken" - Συνδεθείτε με το GitHub και επιτρέψτε στο GitKraken να αποκτήσει πρόσβαση στον λογαριασμό σας στο GitHub.
(προαιρετικά) Πηγαίνετε στο Αρχείο -> Προτιμήσεις και ορίστε τον κατάλογο του έργου σας στη ρίζα των τοπικών αποθετηρίων σας.
Κάντε Fork αυτού του αποθετηρίου
Κάντε fork αυτό το αποθετήριο κάνοντας κλικ στο κουμπί fork στην κορυφή αυτής της σελίδας.
Αυτό θα δημιουργήσει ένα αντίγραφο αυτού του αποθετηρίου στο λογαριασμό σας.
Κλωνοποίηση του αποθετηρίου
Στο GitKraken, πηγαίνετε στο Αρχείο -> Κλωνοποίηση Αποθετηρίου.
Επιλέξτε το GitHub.com στο δεξί πλαίσιο. Κάτω από το όνομα χρήστη σας, θα πρέπει να δείτε το first-contributions. Κάντε κλικ σε αυτό το αποθετήριο και ελέγξτε την πλήρη διαδρομή που εμφανίζεται στο κάτω μέρος αυτού του παραθύρου.
Μόλις είστε ικανοποιημένοι με τη διαδρομή, κάντε κλικ στο "Κλωνοποίηση του αποθετηρίου!".
Δημιουργία παρακλαδιού
Κάντε κλικ στο κουμπί παρακλαδιού στη γραμμή εργαλείων.
Ονομάστε το παρακλάδι σας "προσθήκη-του-ονόματός-σας", για παράδειγμα: "προσθήκη-ονόματος-William-Sutton"
Κάντε τις απαραίτητες αλλαγές και δεσμεύστε αυτές τις αλλαγές
Ανοίξτε τώρα το αρχείο Contributors.md σε έναν επεξεργαστή κειμένου και προσθέστε το όνομά σας σε αυτό, και στη συνέχεια αποθηκεύστε το αρχείο.
Εάν έχετε το αποθετήριο ανοικτό στο GitKraken, θα δείτε ότι υπάρχουν αλλαγές. Ελέγξτε και κάντε stage αυτές τις αλλαγές επιλέγοντας την νεότερη δέσμευση που είναι σημειωμένη με "// WIP" και τον αριθμό των αρχείων που έχουν αλλάξει και τον τύπο της αλλαγής.
Επανεξετάστε τα αρχεία που έχουν αλλάξει και αποφασίστε τι θέλετε να τα κάνετε stage. Το staging είναι σημαντικό για να πείτε στο Git ακριβώς ποιες αλλαγές αρχείων θέλετε να συσχετίσετε με αυτήν τη δέσμευση.
Αφού έχετε ένα καλό μήνυμα δεσμεύσεως ("Προσθήκη <του-ονόματός-σας> στη λίστα συνεισφερόντων" ακούγεται ωραίο και περιγραφικό) και είστε ικανοποιημένοι με τις αλλαγές σας, μπορείτε να πατήσετε "Stage όλων των αλλαγών" για να κάνετε stage όλα όσα έχουν τροποποιηθεί ή "Stage αρχείου" για να κάνετε stage ένα μεμονωμένο αρχείο.
Εάν αλλάξετε γνώμη, μπορείτε να ακυρώσετε το staging αυτών των αλλαγών ή να τις απορρίψετε εντελώς. ΠΡΟΕΙΔΟΠΟΙΗΣΗ: Όπως υποδηλώνει η λέξη απόρριψη, αυτή είναι μια καταστροφική λειτουργία. Κάντε αυτό μόνο εάν δεν θέλετε καμία αλλαγή από το αποθετήριο στο οποίο βρίσκεστε.
Πατήστε δέσμευση.
Συγχαρητήρια, έχετε δεσμεύσει όλες τις αλλαγές στο τοπικό αντίγραφο του κλαδιού σας του δικού σας fork του first-contributions. Συνεχίζουμε!
Ανέβασμα αλλαγών στο GitHub
Πατήστε το κουμπί Ανέβασμα στη γραμμή εργαλείων.
Υποβάλετε αλλαγές στο παρακλάδι origin εάν θέλετε οι αλλαγές να αντανακλούν απευθείας στον παρακλάδι master, διαφορετικά επιλέξτε το κατάλληλο παρακλάδι που θέλετε να ανεβάσετε.
Υποβολή των αλλαγών σας για αξιολόγηση
Εάν πάτε στο αποθετήριο σας στο github, θα δείτε το κουμπί "Σύγκριση & αίτηση εξαγωγής". Κάντε κλικ σε αυτό το κουμπί.
Τώρα υποβάλετε το αίτημα εξαγωγής.
Σύντομα θα ενσωματώσω όλες τις αλλαγές σας στον κύριο παρακλάδι αυτού του έργου. Θα λάβετε μια ειδοποίηση με ηλεκτρονικό ταχυδρομείο αφού οι αλλαγές έχουν ενσωματωθεί.
Πού να πάτε από εδώ;
Συγχαρητήρια! Μόλις ολοκληρώσατε την τυπική ροή fork -> clone -> edit -> PR που θα συναντήσετε συχνά ως συνεισφέρων!
Γιορτάστε τη συνεισφορά σας και μοιραστείτε την με τους φίλους σας και τους ακόλουθούς σας πηγαίνοντας στην ιστοσελίδα του διαδικτυακού εργαλείου.
Μπορείτε να εγγραφείτε στην ομάδα μας στο slack εάν χρειάζεστε βοήθεια ή έχετε οποιεσδήποτε ερωτήσεις. Εγγραφή στην ομάδα slack.