Το Hacktoberfest είναι μια ετήσια γιορτή που διαρκεί ένα μήνα με έργα ανοιχτού κώδικα, συντηρητές και συντελεστές. Η εκδήλωση στοχεύει στην προώθηση του ανοιχτού κώδικα και στην ενθάρρυνση των προγραμματιστών να συνεισφέρουν.
Το Hacktoberfest συνοδεύεται από κίνητρα για τους πρώτους 40.000 συμμετέχοντες που λαμβάνουν τέσσερα αιτήματα έλξης που συγχωνεύονται έως τις 31 Οκτωβρίου. Μπορείτε είτε να φυτευτείτε ένα δέντρο στο όνομά σας είτε ένα μπλουζάκι Hacktoberfest.
Όλα ξεκινούν με το πρώτο σας αίτημα έλξης/συγχώνευσης.
Εγγραφή στο Hacktoberfest
Για να λάβετε μέρος στο Hacktoberfest, πρέπει πρώτα να εγγραφείτε για την εκδήλωση στις hacktoberfest.com.
Θα δείτε μια οθόνη παρόμοια με αυτήν:
Πρέπει να έχετε λογαριασμό GitHub ή GitLab για να συμμετάσχετε.
Επιλέξτε την υπηρεσία φιλοξενίας που προτιμάτε και κάντε κλικ στο ΜΥΗΜΕΝΟΣ κουμπί. Κάνοντας κλικ σε αυτό το κουμπί θα ανακατευθυνθείτε στην εφαρμογή που έχετε επιλέξει, η οποία θα σας ζητήσει να εγκρίνετε το Hacktoberfest.
Η εξουσιοδότηση του Hacktoberfest θα σας εγγράψει αυτόματα για την εκδήλωση.
Εύρεση έργων για συνεισφορά στο GitHub & στο GitLab
Μόνο συνεισφορές σε συμμετέχοντα έργα ανοιχτού κώδικα στο GitHub ή GitLab θα μετρήσει για το Hacktoberfest. Πρέπει να έχετε λογαριασμό GitHub ή GitLab για να συμμετάσχετε.
GitHub
Για να βρείτε έργα που συμμετέχουν στο Hacktoberfest στο GitHub:
- Πλοηγηθείτε στο github.com.
- Μεταβείτε στη γραμμή αναζήτησης στο GitHub ή πατήστε το πλήκτρο κάθετο (/) στο πληκτρολόγιό σας.
- Πληκτρολογήστε "Hacktoberfest" και κάντε κλικ στο ΕΙΣΑΓΩ κουμπί.
Ακολουθώντας τα παραπάνω βήματα θα εμφανιστούν πολλά αποτελέσματα, με το θέμα του Hacktoberfest στην κορυφή. Αυτό το θέμα θα σας δώσει μια λίστα με τα αποθετήρια στα οποία μπορείτε να συνεισφέρετε, όπως φαίνεται στην παρακάτω εικόνα.
Εναλλακτικά, μπορείτε να μεταβείτε απευθείας στο GitHub Hacktoberfest θέμα.
GitLab
Για να βρείτε έργα που συμμετέχουν στο Hacktoberfest στο GitLab:
- Πλοηγηθείτε στο gitlab.com.
- Στην αρχική σελίδα, επιλέξτε διερευνήσει δημόσια έργα.
- Στη σελίδα εξερεύνησης έργων, επιλέξτε εξερευνήστε θέματα.
- Στο φιλτράρισμα κατά αναζήτηση πεδίο, πληκτρολογήστε "Hacktoberfest".
Ακολουθώντας τα παραπάνω βήματα θα εμφανιστούν πολλά αποτελέσματα, με πρώτο το θέμα του Hacktoberfest. Αυτό το θέμα θα σας δώσει μια λίστα με τα αποθετήρια στα οποία μπορείτε να συνεισφέρετε, όπως φαίνεται στην παρακάτω εικόνα.
Εναλλακτικά, μπορείτε να μεταβείτε απευθείας στο GitLab Hacktoberfest θέμα.
Δημιουργία αιτήματος έλξης (PR) στο GitHub
Το αίτημα έλξης (PR) είναι μια πρόταση που γίνεται από έναν συνεισφέροντα σε ένα έργο και ζητά από τον συντηρητή του έργου να εξετάσει και να συγχωνεύσει τις προτεινόμενες αλλαγές στο έργο.
Για να κάνετε ένα PR, πρέπει να βρείτε ένα έργο Hacktoberfest στο οποίο θέλετε να συνεισφέρετε. Μόλις βρείτε ένα έργο, κάντε κλικ στο πιρούνι κουμπί στην επάνω δεξιά γωνία:
Η διοχέτευση ενός έργου δημιουργεί ένα αντίγραφο του έργου στον λογαριασμό σας στο GitHub, επιτρέποντάς σας να κάνετε αλλαγές χωρίς να επηρεάζετε το κύριο έργο. Αφού ολοκληρώσετε το έργο, κλωνοποιήστε το αποθετήριο από τον λογαριασμό σας και κάντε τις αλλαγές στο τοπικό σας περιβάλλον ανάπτυξης.
Φροντίστε να διαβάσετε τις οδηγίες συνεισφοράς του έργου και να τις ακολουθήσετε για να αυξήσετε τις πιθανότητες του αιτήματος έλξης σας.
Αφού κάνετε τις αλλαγές και προσθέσετε τη διχαλωμένη έκδοση του αποθετηρίου, πραγματοποιήστε τις αλλαγές χρησιμοποιώντας το Gitκαι σπρώξτε τα στο GitHub.
Όταν οι αλλαγές αντανακλούν στο GitHub, θα λάβετε ένα μήνυμα που θα σας ενημερώνει ότι το πιρούνι σας «δεσμεύεται» πριν από τον κύριο κλάδο, όπως φαίνεται στην παρακάτω εικόνα.
Στη συνέχεια, κάντε κλικ στο συμβάλλει κουμπί στην προτροπή. Κάνοντας κλικ σε αυτό το κουμπί θα σας ζητηθεί να ανοίξετε ένα αίτημα έλξης, όπως φαίνεται στην παρακάτω εικόνα.
Στη συνέχεια, κάντε κλικ στο ανοιχτό αίτημα έλξης κουμπί. Αυτό θα σας μεταφέρει σε μια σελίδα όπου θα διαβάσετε τις οδηγίες συνεισφοράς και έναν τίτλο και περιγραφή για το αίτημα έλξης σας.
Συμπληρώστε τα απαιτούμενα πεδία και κάντε κλικ στο Δημιουργία αιτήματος έλξης κουμπί, όπως φαίνεται στην παρακάτω εικόνα.
Έχετε δημιουργήσει ένα αίτημα έλξης. Τώρα, περιμένετε τους συντηρητές του έργου να ελέγξουν και να συγχωνεύσουν ή να απορρίψουν τη συνεισφορά σας.
Δημιουργία αιτήματος συγχώνευσης στο GitLab
Ένα αίτημα συγχώνευσης είναι πανομοιότυπο με ένα αίτημα έλξης. Η μόνη διαφορά είναι τα αντίστοιχα ονόματά τους.
Για να υποβάλετε ένα αίτημα συγχώνευσης, πρέπει πρώτα να βρείτε ένα έργο Hacktoberfest στο οποίο θέλετε να συνεισφέρετε. Μόλις βρείτε ένα έργο, κάντε κλικ στο κουμπί διχάλας στην επάνω δεξιά γωνία:
Η διοχέτευση ενός έργου δημιουργεί ένα αντίγραφο του έργου στον λογαριασμό σας στο GitLab, επιτρέποντάς σας να κάνετε αλλαγές χωρίς να επηρεάζετε το κύριο έργο. Αφού ολοκληρώσετε το έργο, κλωνοποιήστε το αποθετήριο από τον λογαριασμό σας και κάντε τις αλλαγές στο τοπικό σας περιβάλλον ανάπτυξης.
Φροντίστε να διαβάσετε τις οδηγίες συνεισφοράς του έργου και να τις ακολουθήσετε για να αυξήσετε τις πιθανότητες του αιτήματος έλξης σας.
Αφού κάνετε τις αλλαγές και προσθέσετε τη διχαλωμένη έκδοση του αποθετηρίου, πραγματοποιήστε τις αλλαγές και ωθήστε τα στο GitLab.
Αφού προωθήσετε τις αλλαγές σας στο GitLab, μεταβείτε στο διχαλωτό έργο σας και κάντε κλικ Αιτήματα συγχώνευσης στην πλαϊνή μπάρα. Αυτό θα εμφανίσει μια οθόνη που εξηγεί ένα αίτημα συγχώνευσης και α Νέο αίτημα συγχώνευσης κουμπί. Κάντε κλικ στο Νέο αίτημα συγχώνευσης κουμπί, όπως φαίνεται στην παρακάτω εικόνα.
Στη συνέχεια, θα πρέπει να επιλέξετε ένα πηγή και στόχος κλαδί. ο πηγή υποκατάστημα θα πρέπει να είναι το υποκατάστημα όπου βρίσκονται οι αλλαγές που θέλετε να δεσμεύσετε στο κύριο αποθετήριο. ο στόχος υποκατάστημα θα πρέπει να είναι το κύριο αποθετήριο όπου θέλετε να πραγματοποιήσετε τις αλλαγές σας. Αφού επιλέξετε τους κλάδους, κάντε κλικ στο Συγκρίνετε κλάδους και συνεχίστε κουμπί, όπως φαίνεται στην παρακάτω εικόνα.
Κάνοντας κλικ στο Συγκρίνετε κλάδους και συνεχίστε Το κουμπί θα σας μεταφέρει σε μια σελίδα όπου μπορείτε να εισαγάγετε έναν τίτλο και μια περιγραφή για το αίτημα συγχώνευσης.
Συμπληρώστε τα απαιτούμενα στοιχεία και κάντε κλικ στο Κουμπί δημιουργίας αιτήματος συγχώνευσης, όπως φαίνεται στην παρακάτω εικόνα.
Κάνοντας κλικ σε αυτό το κουμπί δημιουργείται το αίτημα συγχώνευσης. Τώρα πρέπει να περιμένετε τους συντηρητές του έργου να ελέγξουν και να συγχωνεύσουν ή να κλείσουν το αίτημα έλξης.
Όροι και Προϋποθέσεις του Hacktoberfest
Όλες οι συνεισφορές που γίνονται στα έργα Hacktoberfest πρέπει να είναι εντός των ορίων του Hacktoberfest και να μην αποτελούν ανεπιθύμητο περιεχόμενο. Η μη τήρηση των κανόνων του Hacktoberfest μπορεί να προκαλέσει αποκλεισμό από τη διοργάνωση.
Το Hacktoberfest εκδίδει μια περίοδο ελέγχου επτά ημερών για αιτήματα έλξης/συγχώνευσης που ακολουθούν όλες τις οδηγίες. Εάν το PR σας είναι καλό, το έργο θα πρέπει να το δεχτεί για το Hacktoberfest εντός αυτού του χρονικού πλαισίου.
Καλή συνεισφορά!