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ší.

Predpoklady

Skôr než začnete, skontrolujte, či ste prihlásení do svojho konta v službe 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:

  1. Nainštalujte si nástroje systému Git a jazyka Markdown.
  2. Nastavte lokálny odkladací priestor systému Git.
  3. Vykonajte zmeny v dokumentácii.
  4. 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.

Process flow map showing the basic workflow for getting started with the contribution process.

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.