Επισκόπηση του οδηγού συμβολής στο Microsoft Docs

Καλώς ορίσατε στον οδηγό συμβολής του Microsoft Docs!

Η κοινή χρήση των εμπειριών σας με άλλους χρήστες στο Microsoft Learn βοηθά όλους να επιτύχουν περισσότερα. Χρησιμοποιήστε τις πληροφορίες σε αυτόν τον οδηγό για να δημοσιεύσετε ένα νέο άρθρο στο Microsoft Learn ή να κάνετε ενημερώσεις σε ένα υπάρχον δημοσιευμένο άρθρο.

Η κοινή χρήση των εμπειριών σας με άλλους χρήστες στο Learn βοηθά όλους να επιτύχουν περισσότερα. Χρησιμοποιήστε τις πληροφορίες σε αυτόν τον οδηγό για να δημοσιεύσετε ένα νέο άρθρο για να learn.microsoft.com ή να κάνετε ενημερώσεις σε ένα άρθρο που έχει ήδη δημοσιευτεί.

Πολλά από τα σύνολα τεκμηρίωσης της Microsoft είναι ανοιχτού κώδικα και φιλοξενούνται στο GitHub. Δεν είναι όλα τα σύνολα εγγράφων πλήρως ανοιχτός κώδικας, αλλά πολλά έχουν δημόσια αποθετήρια δεδομένων όπου μπορείτε να προτείνετε αλλαγές μέσω αιτημάτων έλξης (PR). Αυτή η προσέγγιση ανοιχτού κώδικα απλοποιεί και βελτιώνει την επικοινωνία μεταξύ μηχανικών προϊόντων, ομάδων περιεχομένου και πελατών και έχει και άλλα πλεονεκτήματα:

  • Τα αποθετήρια δεδομένων ανοιχτού κώδικα σχεδιάζουν δημόσια να λάβουν σχόλια σχετικά με τα έγγραφα που είναι περισσότερο απαραίτητα.
  • Τα αποθετήρια δεδομένων ανοιχτού κώδικα αναθεωρούν ανοιχτά για να δημοσιεύσουν το πιο χρήσιμο περιεχόμενο στην πρώτη μας έκδοση.
  • Τα αποθετήρια δεδομένων ανοιχτού κώδικα ενημερώνονται δημόσια για να διευκολύνουν τη συνεχή βελτίωση του περιεχομένου.

Η εμπειρία χρήστη στο Microsoft Learn ενσωματώνει απευθείας ροές εργασιών GitHub για να το κάνει ακόμα πιο εύκολο. Ξεκινήστε με την επεξεργασία του εγγράφου που προβάλλετε. Εναλλακτικά, μπορείτε να εξετάσετε νέα θέματα ή να δημιουργήσετε ποιοτικά ζητήματα.

Σημαντικό

Όλα τα αποθετήρια που δημοσιεύουν στο Microsoft Learn έχουν υιοθετήσει τον Κώδικα δεοντολογίας ανοιχτού κώδικα της Microsoft ή τον Κώδικα δεοντολογίας του .NET Foundation. Για περισσότερες πληροφορίες, ανατρέξτε στις Συνήθεις ερωτήσεις για τον Κώδικα δεοντολογίας. conduct@dotnetfoundation.org Επικοινωνήστε ή opencode@microsoft.com με οποιαδήποτε ερώτηση ή σχόλιο.

Οι μικρές διορθώσεις ή διευκρινίσεις σε τεκμηρίωση και παραδείγματα κώδικα σε δημόσια αποθετήρια δεδομένων καλύπτονται από τους learn.microsoft.com Όρους χρήσης. Νέες ή σημαντικές αλλαγές δημιουργούν ένα σχόλιο στο αίτημα έλξης, ζητώντας σας να υποβάλετε μια ηλεκτρονική άδεια συμβολής (CLA) εάν δεν είστε υπάλληλος της Microsoft. Πρέπει να συμπληρώσετε την ηλεκτρονική φόρμα για να μπορέσουμε να ελέγξουμε ή να δεχτούμε το αίτημα έλξης σας.

Γρήγορες επεξεργασίες στην τεκμηρίωση

Οι γρήγορες επεξεργασίες απλοποιούν τη διαδικασία αναφοράς και επιδιόρθωσης μικρών σφαλμάτων και παραλείψεων στην τεκμηρίωση. Παρ’ όλες τις προσπάθειες, στα δημοσιευμένα έγγραφα μπορεί να φτάνουν γραμματικά και ορθογραφικά μικρολάθη. Παρόλο που μπορείτε να δημιουργήσετε προβλήματα για να αναφέρετε λάθη, είναι ταχύτερο και ευκολότερο να δημιουργήσετε ένα αίτημα έλξης για να διορθώσετε το πρόβλημα, όταν η επιλογή είναι διαθέσιμη.

  1. Ορισμένες σελίδες εγγράφων σάς επιτρέπουν να επεξεργάζεστε περιεχόμενο απευθείας στο πρόγραμμα περιήγησης. Σε αυτή την περίπτωση, θα δείτε ένα κουμπί Επεξεργασία όπως αυτό που εμφανίζεται παρακάτω. Η επιλογή του κουμπιού Επεξεργασία (ή ισοδύναμα μεταφρασμένο) σας οδηγεί στο αρχείο προέλευσης στο GitHub.

    Θέση της σύνδεσης άρθρου επεξεργασίας.

    Εάν δεν υπάρχει το κουμπί Επεξεργασία , αυτό σημαίνει ότι το περιεχόμενο δεν είναι ανοιχτό σε δημόσιες συνεισφορές. Δημιουργούνται ορισμένες σελίδες (για παράδειγμα, από ενσωματωμένη τεκμηρίωση στον κώδικα) και πρέπει να γίνει επεξεργασία στο έργο στο οποίο ανήκουν.

  2. Επιλέξτε το εικονίδιο μολυβιού για να επεξεργαστείτε το άρθρο. Αν το εικονίδιο μολυβιού είναι απενεργοποιημένο, πρέπει να συνδεθείτε στον λογαριασμό σας GitHub ή να δημιουργήσετε έναν νέο λογαριασμό.

    Θέση της διακλάδησης και εικονίδιο μολυβιού επεξεργασίας.

  3. Επεξεργαστείτε το αρχείο στο πρόγραμμα επεξεργασίας web. Επιλέξτε την καρτέλα Προεπισκόπηση για να ελέγξετε τη μορφοποίηση των αλλαγών σας.

  4. Όταν ολοκληρώσετε την επεξεργασία, κάντε κύλιση στο κάτω μέρος της σελίδας. Στην περιοχή Πρόταση αλλαγών , πληκτρολογήστε έναν τίτλο και προαιρετικά μια περιγραφή για τις αλλαγές σας. Ο τίτλος θα είναι η πρώτη γραμμή του μηνύματος δέσμευσης. Επιλέξτε Πρόταση αλλαγών για να υποβάλετε τις αλλαγές σας:

    Πρόταση και δέσμευση αλλαγών στο αρχείο.

  5. Τώρα που προτείνατε και πραγματοποιήσατε τις αλλαγές σας, πρέπει να ζητήσετε από τους κατόχους του αποθετηρίου δεδομένων να "τραβήξουν" τις αλλαγές σας στο αποθετήριο δεδομένων τους. Αυτό γίνεται χρησιμοποιώντας κάτι που ονομάζεται "αίτημα έλξης" (PR). Όταν επιλέγετε Πρόταση αλλαγών, εμφανίζεται μια νέα σελίδα παρόμοια με την παρακάτω:

    Συγκρίνετε τις αλλαγές και δημιουργήστε αίτημα έλξης.

    Επιλέξτε Δημιουργία αιτήματος έλξης. Στη συνέχεια, εισαγάγετε έναν τίτλο και μια περιγραφή για το αίτημα έλξης και, στη συνέχεια, επιλέξτε Δημιουργία αιτήματος έλξης. Εάν είστε νέος χρήστης του GitHub, ανατρέξτε στο θέμα Πληροφορίες για τα αιτήματα έλξης για περισσότερες πληροφορίες.

  6. Αυτό ήταν! Τα μέλη της ομάδας περιεχομένου θα ελέγξουν το αίτημα έλξης και θα το συγχωνεύσουν όταν εγκριθεί. Ενδέχεται να λάβετε σχόλια που ζητούν αλλαγές.

Το περιβάλλον εργασίας χρήστη επεξεργασίας του GitHub ανταποκρίνεται στα δικαιώματά σας στο αποθετήριο δεδομένων. Οι προηγούμενες εικόνες αφορούν συμβάλλοντες που δεν έχουν δικαιώματα εγγραφής στο αποθετήριο δεδομένων προορισμού. Το GitHub δημιουργεί αυτόματα ένα διπλότυπο του αποθετηρίου δεδομένων προορισμού στον λογαριασμό σας. Το όνομα της διακλάδησης που μόλις δημιουργήθηκε έχει τη φόρμα GitHubUsername/RepositoryName από προεπιλογή. Εάν έχετε πρόσβαση εγγραφής στο αποθετήριο δεδομένων προορισμού, όπως η διακλάδωση, το GitHub δημιουργεί έναν νέο κλάδο στο αποθετήριο δεδομένων προορισμού. Το όνομα της διακλάδωσης έχει την προεπιλεγμένη ενημέρωση κώδικα φόρμαςn, χρησιμοποιώντας ένα αριθμητικό αναγνωριστικό για τη διακλάδωση ενημέρωσης κώδικα.

Χρησιμοποιούμε αιτήματα έλξης για όλες τις αλλαγές, ακόμη και για συμβάλλοντες που έχουν πρόσβαση εγγραφής. Τα περισσότερα αποθετήρια δεδομένων προστατεύουν τον προεπιλεγμένο κλάδο, επομένως οι ενημερώσεις πρέπει να υποβάλλονται ως αιτήματα έλξης.

Η εμπειρία επεξεργασίας εντός του προγράμματος περιήγησης είναι καλύτερη για μικρές ή μη συχνές αλλαγές. Εάν πραγματοποιείτε συμβολές μεγάλης κλίμακας ή χρησιμοποιείτε σύνθετες δυνατότητες του Git (όπως διαχείριση διακλάδωσης ή σύνθετη επίλυση διένεξης συγχώνευσης), πρέπει να δημιουργήσετε ένα διπλότυπο του αποθετηρίου και να εργαστείτε τοπικά.

Σημείωση

Η πιο μεταφρασμένος τεκμηρίωση δεν παρέχει τη δυνατότητα επεξεργασίας ή παροχής σχολίων μέσω του GitHub. Για να στείλετε σχόλια σχετικά με μεταφρασμένο περιεχόμενο, χρησιμοποιήστε το πρότυπο ηλεκτρονικού ταχυδρομείου που είναι διαθέσιμο στη aka.ms/DocSiteLocFeedback.

Αναθεώρηση ανοιχτών αιτημάτων έλξης

Μπορείτε να διαβάσετε νέα θέματα προτού δημοσιευτούν, ελέγχοντας την ανοιχτή ουρά αιτημάτων έλξης. Οι αναθεωρήσεις ακολουθούν τη διαδικασία ροής του GitHub. Μπορείτε να δείτε τις προτεινόμενες ενημερώσεις ή νέα άρθρα σε δημόσια αποθετήρια. Αναθεωρήστε τες και προσθέστε τα σχόλιά σας. Εξετάστε οποιαδήποτε από τα αποθετήρια δεδομένων του Microsoft Learn και ελέγξτε τα ανοιχτά αιτήματα έλξης για τις περιοχές που σας ενδιαφέρουν. Τα σχόλια της κοινότητας για τις προτεινόμενες ενημερώσεις βοηθούν όλη την κοινότητα.

Δημιουργία ποιοτικών ζητημάτων

Τα έγγραφά μας βρίσκονται σε συνεχή εξέλιξη. Τα ουσιαστικά ζητήματα μάς βοηθούν να εστιάσουμε τις προσπάθειές μας στα θέματα μεγαλύτερης προτεραιότητας για την κοινότητα. Όσο περισσότερες λεπτομέρειες καταχωρείτε, τόσο πιο χρήσιμο είναι το ζήτημα. Πείτε μας ποιες πληροφορίες αναζητήσατε. Πείτε μας τους όρους αναζήτησης που χρησιμοποιήσατε. Αν δεν μπορείτε να ξεκινήσετε, πείτε μας πώς θέλετε να αρχίσετε την εξερεύνηση της τεχνολογίας με την οποία δεν είστε εξοικειωμένοι.

Πολλές από τις σελίδες τεκμηρίωσης της Microsoft διαθέτουν μια ενότητα Σχόλια στο κάτω μέρος της σελίδας, όπου μπορείτε να επιλέξετε να αφήσετε σχόλια για το προϊόν ή σχόλια για το περιεχόμενο για την παρακολούθηση ζητημάτων που αφορούν συγκεκριμένα αυτό το άρθρο.

Τα ζητήματα είναι η αρχή της συζήτησης σχετικά με αυτά που χρειάζονται. Η ομάδα περιεχομένου θα ανταποκριθεί σε αυτά τα ζητήματα με ιδέες σχετικά με το τι μπορούμε να προσθέσουμε και θα ζητήσει την απόψή σας. Μόλις δημιουργήσουμε ένα πρόχειρο, θα σας ζητήσουμε να κάνετε αναθεώρηση του αιτήματος έλξης.

Ασχοληθείτε περισσότερο

Άλλα θέματα σε αυτόν τον οδηγό σάς βοηθούν να ξεκινήσετε την παραγωγική συνεισφορά σας στο Microsoft Learn. Εξηγούν την εργασία με αποθετήρια δεδομένων GitHub, εργαλεία Markdown και επεκτάσεις που χρησιμοποιούνται στο περιεχόμενο του Microsoft Learn.