Jaa


Yleiskatsaus Microsoft Learnin dokumentaation muokkaamiseen

Kiitos mielenkiinnostasi Microsoft Learn -dokumentaation muokkaamiseen! Panoksesi auttavat meitä varmistamaan, että dokumentaatiomme on kirjoitettu hyvin, ajan tasalla ja tarkka. Tämän sivun tietojen avulla voit päättää, mikä maksutapa sopii sinulle parhaiten.

Edellytys

Ennen kuin aloitat, varmista, että olet kirjautunut sisään GitHub-tiliin. Jos sinulla ei ole GitHub-tiliä, siirry https://github.com/join osoitteeseen nopea ja ilmainen rekisteröintiprosessi.

Pienet muutokset ohjeisiin

Pienet muutokset ovat nopeita ja helppoja. Pieniä muutoksia ovat esimerkiksi seuraavat:

  • Korjataan kirjoitusvirheitä
  • Yksittäisen artikkelin muokkaaminen
  • Osion lisääminen artikkeliin
  • Virheen korjaaminen
  • Katkenneiden linkkien päivittäminen

Jos teet pieniä muutoksia, tarvitset vain GitHub-tilin!

Voit tehdä pienen muutoksen valitsemalla Muokkaa tätä asiakirjaa - kynäkuvakkeen artikkelin yläosasta. Tämä toiminto vie sinut GitHubin lähdetiedostoon, jossa voit tehdä haluamasi muutokset. Kun olet valmis, sinua kehotetaan luomaan pull-pyyntö (PR) ehdottamaan muutoksia. Katso ohjeet tästä prosessista selaimen dokumentaation muokkaamisesta.

Merkittävät muutokset dokumentaatioon

Suuret muutokset edellyttävät enemmän aikaa ja vaivaa. Merkittäviä muutoksia ovat esimerkiksi seuraavat:

  • Monimutkaiset muutokset, joiden suorittaminen kestää useita päiviä
  • Versiot useisiin artikkeleihin, jotka haluat lähettää yhdessä
  • Uuden artikkelin luominen
  • Osallistuminen usein

Jos teet suuria muutoksia, sinun on ladattava ja asennettava muutamia työkaluja työn helpottamiseksi. Pääset alkuun seuraavasti:

  1. Asenna Git ja Markdown-työkalut.
  2. Määritä paikallinen Git-säilö.
  3. Tee muutoksia dokumentaatioon.
  4. Luo PULL-pyyntö.

Prosessin yleiskatsaus

Alla olevassa prosessin työnkulussa näytetään korkean tason vaiheet, jotka liittyvät pienten ja merkittävien muutosten aloittamiseen. Huomaa, että jotkin kohteet ovat kertaluonteisia vaiheita, kun taas toiset suoritetaan aina, kun aloitat uuden osuuden.

Prosessin työnkulun kartta, joka näyttää perustyönkulun osallistumisprosessin aloittamiseen.

Kuva alkaa päätöspisteellä, onko tämä ensimmäinen osallistumisen aikasi? Jos kyllä, seuraava vaihe on GitHub-tilisi määrittäminen. Jos ei, seuraava vaihe on toinen päätöspiste, onko muutoksesi vähäinen? Jos kyllä, seuraava vaihe on muokkaaminen selaimessa. Jos ei, seuraaviin vaiheisiin kuuluu luontityökalujen asentaminen, säilön lisääminen ja kloonaus, muutosten tekeminen, pull-pyynnön avaaminen sekä pull-pyynnön tarkistaminen ja hyväksyminen.

Muutoksia koulutusmoduuleihin

Osallistujat eivät voi muokata tai ehdottaa muutoksia koulutusmoduuleihin. Tällä hetkellä vain julkisiin säilöihin tallennetut Microsoft Learn -asiakirjat ovat avoinna julkisia osallistumisia varten.