Το αίτημα έλξης (PR) είναι μια δυνατότητα GitHub που σας επιτρέπει να προτείνετε αλλαγές σε ένα αποθετήριο στο οποίο δεν έχετε πρόσβαση εγγραφής. Οι συντηρητές αποθετηρίου μπορούν να ελέγξουν αυτές τις αλλαγές και, εάν το επιλέξουν, να τις συγχωνεύσουν στο αρχικό αποθετήριο.
Το άνοιγμα αιτημάτων έλξης στο GitHub είναι ζωτικής σημασίας για τη συμβολή σε έργα ανοιχτού κώδικα και τη συνεργασία με άλλους προγραμματιστές. Μάθετε πώς να δημιουργείτε και να ανοίγετε ένα αίτημα έλξης στο GitHub με λίγα απλά βήματα.
Βήμα 1: Διαχωρισμός του αποθετηρίου
Ενεργοποίηση ενός αποθετηρίου την πλατφόρμα GitHub δημιουργεί ένα αντίγραφο —αλλιώς γνωστό ως "fork"— αυτού του αποθετηρίου, κάτω από το λογαριασμό σας. Η διοχέτευση ενός αποθετηρίου σάς επιτρέπει να κάνετε αλλαγές στον κώδικα χωρίς να επηρεάζετε το αρχικό αποθετήριο.
Για να σχηματίσετε ένα αποθετήριο, μεταβείτε στην κύρια σελίδα του και κάντε κλικ στο πιρούνι κουμπί στην επάνω δεξιά γωνία:
Συμπληρώστε το όνομα του αποθετηρίου (fork) και μια προαιρετική περιγραφή και κάντε κλικ Δημιουργήστε πιρούνι:
Τώρα έχετε δημιουργήσει ένα αντίγραφο του αρχικού αποθετηρίου. Αυτό το νέο αποθετήριο έχει μια σύνδεση με το πρωτότυπο, έτσι ώστε οι αλλαγές που κάνετε στον κώδικα να μπορούν εύκολα να συγκριθούν και να συγχωνευθούν ξανά σε αυτό.
Βήμα 2: Πραγματοποίηση αλλαγών στον κώδικα
Αφού διαχωρίσετε το αποθετήριο, ίσως χρειαστεί να το κλωνοποιήσετε στον τοπικό σας υπολογιστή, ανάλογα με το μέγεθος και τη φύση των αλλαγών που θέλετε να προτείνετε. Εάν κάνετε πολύ απλές αλλαγές που δεν χρειάζεται να δοκιμάσετε, μπορείτε να το κάνετε online χρησιμοποιώντας το πρόγραμμα επεξεργασίας που βασίζεται στο web GitHub.
Για να κλωνοποιήσετε ένα αποθετήριο στον τοπικό σας υπολογιστή χρησιμοποιώντας το Git, εκτελέστε αυτήν την εντολή τερματικού:
git κλώνος
Αντικαθιστώ με τη διεύθυνση URL του αποθετηρίου σας—μπορείτε να το βρείτε στο GitHub. Αυτή η εντολή θα κλωνοποιήσει το αποθετήριο στον τοπικό σας υπολογιστή, όπου μπορείτε ελεύθερα να πειραματιστείτε και να κάνετε αλλαγές στον κώδικα.
Θα πρέπει να διατηρήσετε τις αλλαγές σας μικρές και εστιασμένες, καθώς τα μεγάλα αιτήματα έλξης μπορεί να είναι δύσκολο να αναθεωρηθούν και να συγχωνευθούν. Προσπαθήστε να διατηρήσετε τις αλλαγές σας συγκεκριμένα σε ένα πρόβλημα ή δυνατότητα, για να διευκολύνετε τους συντηρητές να τις ελέγξουν και να τις αποδεχτούν.
Αφού κάνετε τις αλλαγές που επιθυμείτε τοπικά, πραγματοποιήστε τις και σπρώξτε τις στο πιρούνι του GitHub χρησιμοποιώντας το Git.
Βήμα 3: Άνοιγμα ενός αιτήματος έλξης
Αφού ολοκληρώσετε τις αλλαγές σας στο GitHub, θα πρέπει να δείτε μια προτροπή που θα σας ειδοποιεί ότι το υποκατάστημά σας είναι ένας αριθμός "δεσμεύσεων" πριν από το αποθετήριο από το οποίο το διακλάδωσες, για παράδειγμα:
Κάντε κλικ στο Συμβάλλει αναπτυσσόμενη λίστα. Κάνοντας κλικ σε αυτό το κουμπί θα σας ζητηθεί να ανοίξετε ένα αίτημα έλξης. Στη συνέχεια, κάντε κλικ στο Ανοίξτε το αίτημα έλξης κουμπί:
Ορισμένα αποθετήρια έχουν συγκεκριμένες οδηγίες συνεισφοράς, τις οποίες μπορείτε συνήθως να βρείτε σε ένα αρχείο CONTRIBUTING.md, τις οποίες πρέπει να ακολουθήσετε. Φροντίστε να διαβάσετε και να ακολουθήσετε αυτές τις οδηγίες προτού υποβάλετε αίτημα έλξης.
Στη συνέχεια, συμπληρώστε τα απαιτούμενα πεδία και κάντε κλικ στο Δημιουργία αιτήματος έλξης κουμπί:
Το μήνυμα δέσμευσής σας πρέπει να είναι σαφές και περιεκτικό, να περιγράφει τις αλλαγές που κάνατε και το σκεπτικό πίσω από αυτές. Αυτό θα βοηθήσει τους συντηρητές να κατανοήσουν τις αλλαγές σας και θα τους διευκολύνει να ελέγξουν τον κώδικα.
Μόλις δημιουργήσετε το pull σας, θα πρέπει να περιμένετε να το ελέγξουν και να το συγχωνεύσουν ή να το κλείσουν οι συντηρητές του έργου. Οι συντηρητές μπορεί να έχουν προτάσεις ή σχόλια σχετικά με το αίτημα έλξης σας. Να είστε ανοιχτοί σε αλλαγές και πρόθυμοι να κάνετε αναθεωρήσεις εάν σας το ζητήσουν.
Η σημασία των αιτημάτων έλξης
Τα αιτήματα έλξης διευκολύνουν τη συνεργασία μεταξύ των προγραμματιστών, επιτρέποντάς τους να προτείνουν αλλαγές, να παρέχουν σχόλια και να ελέγχουν τον κώδικα. Αυτό βοηθά στην ενίσχυση της αίσθησης της κοινότητας και της συνεργασίας στο πλαίσιο ενός έργου, οδηγώντας σε περισσότερες συνεισφορές και ταχύτερη ανάπτυξη.
Επιπλέον, τα αιτήματα έλξης οργανώνουν το ιστορικό του έργου και την έκδοση εκδόσεων επιτρέποντας στους συντηρητές να παρακολουθούν τις διαφορετικές εκδόσεις του κώδικα και τις αλλαγές που έγιναν σε κάθε έκδοση.