GitHub-problémák létrehozása nyílt forráskódú termékekhez

Ez a cikk bemutatja, hogyan hozhat létre GitHub-problémát a Nyílt forráskódú termékekhez kapcsolódó Microsoft Learn-dokumentációhoz. Azt is bemutatja, hogyan használhatja más felhasználók problémáit, és hogyan adhat hozzá saját megjegyzéseket hozzájuk, vagy megnyithat egy lekéréses kérelmet (PR) a problémák megoldásához.

Nyílt forráskódú termékdokumentációnk folyamatos, folyamatban lévő munka. Ha jó GitHub-problémákat kap a közreműködőktől, az segít, hogy erőfeszítéseink a közösség legfontosabb prioritásaira összpontosítsanak.

Természetesen, ha tudja, hogyan háríthat el egy hibát, kérjük, hogy saját maga végezze el a módosításokat a probléma megnyitása helyett.

Előfeltételek

• Hozzon létre egy GitHub-fiókot, ha nem rendelkezik ilyen fiókkal.

Probléma létrehozása

1. Lépjen arra a cikkre, amelyhez megjegyzést szeretne fűzni.

2. Görgessen a cikk aljára, ahol megtekintheti a visszajelzés elküldésének lehetőségeit. Új probléma létrehozásához válassza a Dokumentáció megnyitása lehetőséget . Ez a visszajelzés a tartalomra vonatkozik, és a GitHubon problémaként jelenik meg.

   

   Ha szeretné, válassza a Termékvisszajelzés megadása lehetőséget egy célhelyre (például egy visszajelzési portálra, a GitHubra, egy e-mail-címre), ahol visszajelzést küldhet magáról a termékről. Ez a visszajelzés független a tartalomtól, és nincs kapcsolata az eredeti cikkhez.

3. A rendszer új problémát nyit meg Önnek a GitHub-adattárban, amely a megtekintett cikk tartalmát tárolja. Adjon hozzá egy címet és egy leírást; az összes többi mezőt automatikusan fel kell töltenie. Ha elkészült, válassza az Új probléma elküldése lehetőséget.

   

   Minél több részletet ad meg, annál hasznosabb a probléma. Mondja el, hogy milyen információkat keresett, vagy milyen keresési kifejezéseket használt a cikk eléréséhez. Ha nem tudta megtenni az első lépéseket, mondja el, hogyan szeretné elkezdeni egy új technológia felfedezését. Képernyőképeket vagy fájlokat is hozzáadhat a probléma megértéséhez.

Ennyi az egész! A probléma most bekerül a Problémák üzenetsorba. A problémák jelzésével elindul a párbeszéd arról, hogy mire van szükség. A tartalomért felelős csapat ötletekkel válaszol ezekre a problémákra, hogy mit adhatunk hozzá, és kikérhetjük a véleményüket.

Megjegyzés egy problémához

A GitHub-problémákat támogató adattárakban bármilyen problémához megjegyzést fűzhet. Saját megjegyzéseket is hozzáadhat egy ön által létrehozott problémához.

1. Keresse meg azt a problémát, amelyhez megjegyzést szeretne fűzni. A böngészőben keresse meg azt a GitHub-adattárat, amelynél a problémákat meg szeretné vizsgálni. Válassza a Problémák lapot az adattár nyitott problémáinak megtekintéséhez. Ha az adattár sok problémával rendelkezik, 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. Miután megtalálta az Önhöz hasonló problémát, válassza ki a megnyitásához.

   Csak a nyílt forráskódú visszajelzési felületet használó nyílt forráskódú termékek fogadják el a GitHub-problémákat. További információ és a részt vevő adattárak listája: A nyílt forráskódú felület használata.

2. Olvassa el a problémát és a mások által már hozzáadott megjegyzéseket. Ha megjegyzést szeretne fűzni, görgessen a probléma aljára, és írja be a megjegyzését a Megjegyzés elhagyása mezőbe. Ha elkészült, válassza a Megjegyzés lehetőséget.

   

Lekéréses kérelem megnyitása a problémák megoldásához

A problémák böngészése közben előfordulhat, hogy olyant talál, amelyről tudja, hogyan kell kijavítani. Ha igen, megnyithat egy lekéréses kérelmet a probléma megoldásához. További információ: Dokumentáció szerkesztése a böngészőben.

Miután megnyitott egy pr-t a probléma megoldásához, térjen vissza a problémához, és adjon hozzá egy megjegyzést, amely a kérelemre hivatkozik. Ez segít a probléma és a pr együttes nyomon követésében. Használja a fontjelet (#), majd a PR-számot a PR-hez való csatoláshoz. Ha például a PR-szám 4210, akkor a megjegyzésbe kell beírnia #4210 .