Αυτός ο οδηγός είναι για όσους θέλουν να συμμετάσχουν στο έργο ως συντηρητές, για να βοηθήσουν στη διαχείριση και τη διατήρηση του έργου για την κοινότητα. (Αυτός δεν είναι ένας οδηγός για τους συνεισφέροντες για πρώτη φορά)
Αυτό το σεμινάριο είναι επίσης διαθέσιμο σε άλλες γλώσσες
Μεταφράσεις για τεκμηρίωση έργων είναι ευπρόσδεκτες. Διαβάστε τον
Οδηγό μετάφρασηςγια να συνεισφέρετε.
Ο κύριος στόχος μας είναι να δώσουμε στους συνεργάτες μας την ταχύτερη δυνατή ανατροφοδότηση από το σημείο που θα υποβάλουν το αίτημα έλξης τους. Αυτό σημαίνει πρωτίστως την παροχή ελέγχων κώδικα και τη συγχώνευση αποδεκτών PR. Εκτός από αυτό, μπορούμε να διατηρήσουμε το έργο διασφαλίζοντας ότι όλα λειτουργούν σωστά και όσο πιο χρήσιμα και χρήσιμα μπορεί να είναι για τους συντελεστές μας.
Όποιος έχει κάποιες δεξιότητες Git και GitHub. Δεν χρειάζεται να είστε ειδικός, αυτός ο οδηγός θα πρέπει να βοηθήσει ακόμα και αρχάριους. Αυτό είναι ένα ενεργό έργο που λαμβάνει τακτικές συνεισφορές και βοηθά πολλούς ανθρώπους να κάνουν την πρώτη τους συνεισφορά ανοιχτού κώδικα. Το να είστε συντηρητής σε αυτό το έργο βοηθάει να διασφαλίσουμε ότι θα συνεχίσει να προσφέρει στους συντελεστές μας μια καλή πρώτη εμπειρία και να τους ενθαρρύνει να συνεισφέρουν περισσότερο.
Μπορείτε να αφιερώσετε όσο χρόνο θέλετε για αυτό. Ελπίζουμε ότι μπορούμε να συνεχίσουμε να λειτουργεί ομαλά.
- Μεταβείτε στην ενότητα αιτήματος έλξης του έργου, ξεκινήστε με το παλαιότερο αίτημα έλξης που δεν βρίσκεται σε κατάσταση «αιτούνται αλλαγές».
- Ανοίξτε ένα PR και μεταβείτε στην καρτέλα αλλαγών αρχείων και ξεκινήστε έναν έλεγχο κώδικα.
- Ελέγξτε το PR, βεβαιωθείτε ότι ακολουθεί τις προδιαγραφές στο σεμινάριο.
- Βεβαιωθείτε ότι το HTML, οι σύνδεσμοι και τα δεδομένα είναι όλα σωστά. Βεβαιωθείτε ότι η κάρτα είναι τοποθετημένη στην αρχή του αρχείου εκεί που θα έπρεπε.
- Επόμενος έλεγχος για τυχόν διενέξεις. Συγχωνεύστε το "master" στον κλάδο δημοσίων σχέσεων για να διορθώσετε τις διενέξεις. Οι συγκρούσεις συμβαίνουν συνήθως όταν έχει περάσει καιρός από τις προηγούμενες συγχωνεύσεις και αρκετοί PR χρησιμοποιούν την ίδια παρωχημένη έκδοση.
- Εάν συμβαίνει αυτό, διορθώστε τη σύγκρουση. Συνήθως θα πρέπει να προσθέσετε τη νέα κάρτα πάνω από τις κάρτες που είχαν προστεθεί από τότε που φτιάχτηκε το πιρούνι.
- Εάν όλα τα άλλα είναι εντάξει, εγκρίνετε το PR, γράψτε ένα μήνυμα στον συνεισφέροντα ευχαριστώντας τον για τη συνεισφορά (να θυμάστε ότι είναι πρώτοι και θα ωφεληθούν από την ενθάρρυνση).
- Συγχώνευση του PR σε «κύριο».
- Μερικές φορές υπάρχουν προβλήματα με το PR που πρέπει να επιδιορθωθούν από τον συνεργάτη, όπως λάθος διακλάδωση, σπασμένο HTML, πληροφορίες που λείπουν, κάρτα τοποθετημένη σε λάθος μέρος. Οτιδήποτε δεν ακολουθήθηκε σωστά (και όχι απλές διενέξεις συγχώνευσης).
- Ξεκινήστε έναν έλεγχο κώδικα στο GitHub και ζητήστε αλλαγές. Προσπαθήστε να είστε όσο το δυνατόν πιο περιγραφικοί, σχολιάστε την ακριβή γραμμή, πείτε τους ακριβώς ποιο είναι το πρόβλημα και πώς να το διορθώσετε και ενθαρρύνετέ τους ότι αυτό είναι ένα φυσιολογικό μέρος της διαδικασίας αναθεώρησης δημοσίων σχέσεων.
- Όταν είστε έτοιμοι, υποβάλετε την κριτική.
- Παρακολουθήστε τη συζήτηση σε περίπτωση που ο συνεργάτης έχει επακόλουθες ερωτήσεις με τις οποίες μπορείτε να βοηθήσετε. Στόχος μας είναι να περάσουν όλοι από τη γραμμή τερματισμού, γι' αυτό προσπαθούμε να τους οδηγήσουμε μέχρι εκεί.
- Μόλις διορθώσουν τις ζητούμενες αλλαγές, το PR μπορεί να συγχωνευθεί σε «κύριο».
Παρακαλούμε, να ελέγχετε πάντα ότι οι αλλαγές δεν έχουν σπάσει το έργο και ότι η ζωντανή σελίδα εξακολουθεί να λειτουργεί όπως αναμένεται. Είναι πάντα καλύτερο να δοκιμάζετε τις αλλαγές τοπικά πριν από τη συγχώνευση και να μην συγχωνεύετε ποτέ οτιδήποτε φαίνεται ύποπτο.
Εάν δεν υπάρχουν πολλά συσσωρευμένα PR, όλη αυτή η διαδικασία μπορεί να γίνει απευθείας στη σελίδα GitHub του έργου. Ωστόσο, δεν είναι ασυνήθιστο να περιμένουν μερικοί PR και τότε θα υπάρξουν αναπόφευκτα κάποιες συγκρούσεις συγχώνευσης. Μπορείτε να χρησιμοποιήσετε οποιαδήποτε εργαλεία που γνωρίζετε για να δείτε διαφορές και να διορθώσετε διενέξεις. Συνιστώ τη χρήση ενός εργαλείου όπως το GitKraken. Είναι οπτικό και επιτρέπει την ευκολότερη διαχείριση του έργου όταν πρέπει να γίνουν μερικά PR. Κατεβάστε το GitKraken, κλωνοποιήστε το έργο. Η χρήση ενός συνδυασμού του προγράμματος επεξεργασίας κώδικα και του ενσωματωμένου εργαλείου συγκρούσεων συγχώνευσης του GitKraken σάς δίνει τον πλήρη έλεγχο για γρήγορη διεκπεραίωση PR, διόρθωση διενέξεων και συγχώνευση.
Το έργο έχει εγκαταστήσει τον Prettier για να διασφαλίσει ότι ανεξάρτητα από τον τρόπο με τον οποίο ένας συνεργάτης υποβάλλει το PR, ο οδηγός στυλ θα επιβληθεί. Το έργο με αυτόν τον τρόπο διατηρείται πάντα με την ίδια εσοχή και ύφος. Εάν παρατηρήσετε ότι το αρχείο HTML φαίνεται ακατάστατο, εκτελέστε τον παρακάτω κώδικα στη ρίζα του έργου.
npx prettier --write index.htmlΘα πρέπει να προσπαθήσει να μορφοποιήσει το αρχείο και αν δεν μπορεί θα σας δείξει τα σφάλματα. Μερικές φορές μια ετικέτα κλεισίματος που λείπει ή ένα κατεστραμμένο HTML συγχωνεύεται κατά λάθος και αυτός είναι ένας καλός τρόπος για να το εντοπίσετε και να το διορθώσετε.
Εάν έχετε ποτέ αμφιβολίες, μπορείτε πάντα να αναφέρετε εμένα ή τους άλλους συντηρητές στο ίδιο το PR ή να μου στείλετε DM στο [Twitter] (https://twitter.com/Syknapse).
Ελάτε μαζί μας για να βοηθήσουμε να αναπτύξουμε αυτό το έργο μαζί. Επικοινωνήστε μαζί μου στο Twitter και στείλτε μου το όνομα χρήστη σας στο GitHub για να σας προσθέσω. Μπορείτε επίσης να εγγραφείτε στην Κοινότητα Discord μας κάνοντας κλικ στο παρακάτω κουμπί: