Megosztás a következőn keresztül:

Nyitott lekéréses kérelmek áttekintése a GitHubon

  • Cikk

Ez a cikk bemutatja, hogyan járulhat hozzá a Microsoft Learnhez a lekéréses kérelmek (PRs) áttekintésével és megjegyzéseinek hozzáadásával. A nyilvános GitHub-adattár nyitott PR-üzenetsorának ellenőrzésével elolvashatja az új témaköröket, és megtekintheti a javasolt frissítéseket a közzététel előtt. A javasolt frissítéseket illető közösségi visszajelzések az egész közösséget segítik.

Pr-megjegyzésekkel és értékelésekkel a következőt teheti:

  • A kérelemhez fűzött megjegyzések hozzáadása és megválaszolása.
  • Reagáljon az olyan hangulatjelekkel rendelkező megjegyzésekre, mint a 👍, ❤️ és 🎉 .

Előfeltételek

Lekéréses kérelem keresése

  1. A böngészőben keresse meg a megtekinteni kívánt GitHub-adattárat. Ha nem biztos abban, hogy melyik adattárat kell megnéznie, keresse meg a Microsoft Learn-adattárak listájában az Önt érdeklő tárházat.

    Ha a dokumentációt böngészi, és nem tudja, hogy melyik adattárhoz tartozik, válassza a Ceruza szerkesztése ikont a lap tetején. Ez a művelet a GitHub forrásfájljára viszi. Az adattár neve a lap bal felső sarkában jelenik meg. Az alábbi képen például az adattár nevének helye azure-dev-docs látható.

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. A Lekéréses kérelmek lapra kattintva megtekintheti az adattárhoz tartozó nyitott PRs-eket. Ha az adattár sok PR-t használ, a Szűrők sávon címkék, szerzők és egyebek szerint szűrhet. Vagy a keresősávon kereshet konkrét lekérdezéseket.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Nyisson meg egy pr-t a címhivatkozás kiválasztásával.

Lekéréses kérelem áttekintése

  1. Az éppen vizsgált lekéréses kérelemben válassza a Módosított fájlok lapot.

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Hasonlítsa össze az eredeti dokumentumot a szerkesztett dokumentumával. Az eredeti dokumentum piros, a javasolt dokumentum pedig zöld színű lesz. A hozzáadott szövegek a zöld (új) szakaszban lesznek kiemelve, a törölt szövegek pedig a piros (eredeti) szakaszban lesznek kiemelve.

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Megjegyzéseket fűzhet vagy módosításokat javasolhat a megjegyzést fűzni kívánt sortól balra található plusz (+) ikonra. Több vonal kijelöléséhez jelölje ki és húzza a pluszjelet.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Csak az aktuális kérelemben szerkesztett sorokhoz adhat hozzá megjegyzéseket vagy javaslatokat. Ha más módosításokat szeretne végezni, szerkessze a fájlt a saját pr-fájljában.

  4. Megnyílik egy mező. Itt adhatja meg észrevételeit vagy kérdéseit. Ha szeretné, az eszköztár gombjaival formázhatja a szöveget, felvehet listajeles és számozott listákat, vagy beszúrhat kódblokkokat és képeket.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Azt is javasolhatja, hogy módosítsa az adott sor szövegét.

    1. A megjegyzés eszköztárában válassza ki az +- ikont (valószínűleg a bal szélső ikont). Ez a Javaslat beszúrása gomb.

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. A kijelölt sor szövegét egy kódblokk tartalmazza (két """ háttérkészleten belül).

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Ha háromjeles kódkerítést (''') tartalmazó szövegmódosítást szeretne javasolni, cserélje le a külső/mellékelő suggestion háttérrendszereket tildes (~~~) szövegre.

    3. Szerkessze a szöveget. A megjegyzésmező gombjaival egyszerűen formázhat például félkövér, dőlt és listajeles formázást, vagy használhatja közvetlenül a Markdown-szintaxis elemeit . A kódblokk szakasz alatt megjegyzéseket is fűzhet ehhez a mezőhöz.

  6. Miután megjegyzést fűzött, válassza a Véleményezés indítása lehetőséget. A pr szerző értesítést kap a változásokról. Ha az előző lépésben a Javaslat beszúrása gombot használta, a szerző közvetlenül a dokumentumra véglegesíti a javaslatot.

    Ha másokat szeretne bevonni a beszélgetésbe, a megjegyzéseiben @mention más közreműködőket is a GitHub-aliasukkal. Az említett GitHub-felhasználók egy e-mailt kapnak, amely tartalmazza a megjegyzését. A megjegyzésekben a Markdownt is használhatja, és a megjegyzés elküldése után a megjegyzés Markdownja is megjelenik.

  7. A Beszélgetések lapon olvassa át a megjegyzéseket. Ha kérdései vagy megjegyzései vannak, vegye fel őket a beszélgetésbe. A megjegyzésekre adott reakciókat úgy is hozzáadhatja, ha az egyes megjegyzések bal alsó sarkában a mosolygó arc ikont választja.

Véleményezés elküldése

Miután hozzáadta az összes megjegyzését a felülvizsgálathoz, küldje el a véleményezést.

  1. A Véleményezés elküldése párbeszédpanel megnyitásához válassza a Módosított fájlok lap jobb felső sarkában található Változások áttekintése gombot.
  2. Adjon meg egy leíró áttekintési összegzést.
  3. Válassza a kívánt véleményezés típusához tartozó választógombot, majd válassza a Véleményezés elküldése lehetőséget.

Submitting a review in GitHub.

A pr szerző értesítést kap a felülvizsgálatról.

Következő lépések

Ha többet szeretne megtudni a megjegyzésekről és a véleményekről, tekintse meg ezeket a cikkeket a GitHub dokumentációjában.