Επισκόπηση της επεξεργασίας τεκμηρίωσης στο Microsoft Learn

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

Προαπαιτούμενα στοιχεία

Προτού ξεκινήσετε, βεβαιωθείτε ότι έχετε εισέλθει στον λογαριασμό σας GitHub. Εάν δεν έχετε έναν λογαριασμό GitHub, μεταβείτε στο https://github.com/join για μια γρήγορη και δωρεάν διαδικασία εγγραφής.

Μικρές αλλαγές στην τεκμηρίωση

Οι μικρές αλλαγές είναι γρήγορες και εύκολες. Ορισμένα παραδείγματα δευτερευουσών αλλαγών είναι τα εξής:

• Διόρθωση τυπογραφικά λάθη
• Αναθεώρηση μεμονωμένου άρθρου
• Προσθήκη ενότητας σε άρθρο
• Διόρθωση σφάλματος
• Ενημέρωση κατεστραμμένων συνδέσεων

Εάν κάνετε μικρές αλλαγές, το μόνο που χρειάζεστε είναι ένας λογαριασμός GitHub!

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

Σημαντικές αλλαγές στην τεκμηρίωση

Οι σημαντικές αλλαγές αφορούν περισσότερο χρόνο και προσπάθεια. Ορισμένα παραδείγματα σημαντικών αλλαγών είναι τα εξής:

• Σύνθετες αλλαγές που θα σας χρειαστούν αρκετές ημέρες για να ολοκληρώσετε
• Αναθεωρήσεις σε πολλά άρθρα που θέλετε να υποβάλετε μαζί
• Δημιουργία νέου άρθρου
• Συμβολή συχνά

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

1. Εγκαταστήστε τα εργαλεία Git και Markdown.
2. Ρυθμίστε ένα τοπικό αποθετήριο δεδομένων Git.
3. Κάντε αλλαγές στην τεκμηρίωση.
4. Δημιουργήστε ένα PR.

Επισκόπηση διαδικασίας

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

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

Αλλαγές στις εκπαιδευτικές ενότητες

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