Prehľad úprav dokumentácie na lokalite Microsoft Learn
Ďakujeme za záujem o úpravu dokumentácie na lokalite Microsoft Learn. Vaše príspevky nám pomáhajú zabezpečiť, aby bola naša dokumentácia dobre napísaná, aktuálne a presná. Informácie na tejto stránke vám pomôžu rozhodnúť sa, ktorý spôsob prispievania je pre vás najvhodnejší.
Predpoklad
Skôr než začnete, skontrolujte, či ste prihlásení do svojho konta GitHub. Ak nemáte konto v službe GitHub, prejdite na https://github.com/join rýchly a bezplatný proces registrácie.
Drobné zmeny v dokumentácii
Drobné zmeny sú rýchle a jednoduché. Medzi menšie zmeny patria tieto:
- Oprava preklepov
- Prehodnotenie jedného článku
- Pridanie sekcie do článku
- Oprava chyby
- Aktualizácia nefunkčných prepojení
Ak robíte drobné zmeny, všetko, čo potrebujete, je konto GitHub!
Ak chcete vykonať drobné zmeny, v hornej časti článku vyberte ikonu ceruzky Upraviť tento dokument . Táto akcia vás prestúpi do zdrojového súboru v službe GitHub, kde môžete vykonať zmeny. Po dokončení sa zobrazí výzva na vytvorenie žiadosti o prijatie zmien (PR) s cieľom navrhnúť zmeny. Úplný návod tohto procesu nájdete v téme Úprava dokumentácie v prehliadači.
Hlavné zmeny v dokumentácii
Veľké zmeny zahŕňajú viac času a úsilia. Príkladmi veľkých zmien sú:
- Komplexné zmeny, ktoré bude trvať niekoľko dní
- Revízie viacerých článkov, ktoré chcete odoslať dohromady
- Vytvorenie nového článku
- Často prispievanie
Ak robíte veľké zmeny, musíte si stiahnuť a nainštalovať niekoľko nástrojov, aby ste si uľahčili prácu. Ak chcete začať, postupujte podľa týchto krokov:
- Nainštalujte si nástroje systému Git a jazyka Markdown.
- Nastavte lokálny odkladací priestor systému Git.
- Vykonajte zmeny v dokumentácii.
- Vytvorenie žiadosti o prijatie zmien
Prehľad procesov
Postup procesu uvedený nižšie zobrazuje kroky vysokej úrovne, ktoré sa podieľajú na začatí v prípade malých a veľkých zmien. Všimnite si, že niektoré položky predstavujú jednorazové kroky, zatiaľ čo iné sa vyskytujú pri každom spustení nového príspevku.
Obrázok začína rozhodovacím bodom: Prispievate do toho prvýkrát? Ak áno, ďalším krokom je nastavenie vášho konta v službe GitHub. Ak nie, ďalším krokom je rozhodovanie, je zmena malá? Ak áno, ďalším krokom je úprava v prehliadači. Ak nie, ďalšie kroky zahŕňajú inštaláciu vývojárskych nástrojov, vetvenie a klonovanie odkladacieho priestoru, vykonávanie zmien, otvorenie žiadosti o prijatie zmien a kontrolu a odhlásenie vašej žiadosti o prijatie zmien.
Zmeny v školiacich moduloch
Prispievatelia nemôžu upravovať ani navrhovať zmeny školiacich modulov. V súčasnosti je pre verejné príspevky otvorená len dokumentácia služby Microsoft Learn uložená vo verejných odkladacích priestoroch.