Lekéréses kérelmek elküldése

A tartalom módosításához küldjön lekéréses kérelmet (PR) az elágazásból. Az egyesítendő lekéréses kérelmeket felül kell vizsgálni. A legjobb eredmény érdekében tekintse át a szerkesztői ellenőrzőlistát a lekéréses kérelem elküldése előtt.

Git-ágak használata

A PowerShell-Docs alapértelmezett ága az main ág. A munkaágakban végzett módosítások egyesítve lesznek az ágban a main közzététel előtt. Az main ág minden hétköznap 15:00-kor (csendes-óceáni idő szerint) egyesül az live ágban. Az live ág tartalmazza a docs.microsoft.com közzétett tartalmat.

A módosítások megkezdése előtt hozzon létre egy munkaágat a PowerShell-Docs-adattár helyi példányában. Ha helyileg dolgozik, mindenképpen szinkronizálja a helyi tárházat a munkaág létrehozása előtt. A munkaágat az ág frissítési main másolatából kell létrehozni.

Minden lekéréses kérelemnek az ágat main kell céloznia. Ne küldjön módosítást az live ágra. Az ágon main végrehajtott módosítások egyesítve lesznek live, felülírva a livebenne végrehajtott módosításokat.

A lekéréses kérelem folyamatának jobb működése mindenki számára

Minél egyszerűbb és koncentráltabb a lekéréses kérelem, annál gyorsabban áttekinthető és egyesíthető.

Kerülje a nagy számú fájlt frissítő vagy nem kapcsolódó módosításokat tartalmazó lekéréses kérelmeket

Ne hozzon létre nem kapcsolódó módosításokat tartalmazó lekéréses kérelmeket. Kezelje külön a létező cikkek kisebb módosításait és a teljesen új cikkeket vagy jelentősebb módosításokat. Használjon külön-külön munkaágat a két típusú módosításokhoz.

A tömeges módosítások nagy számú módosított fájllal rendelkező lekéréses kérelmeket hoznak létre. A lekéréses kérelmeket érdemes legfeljebb 50 módosított fájlra korlátozni. A nagyméretű lekéréses kérelmeket nehezebb elbírálni, és hibák is nagyobb valószínűséggel maradnak bennük.

Fájlok átnevezése vagy törlése

Fájlok átnevezésekor vagy törlésekor a lekéréses kérelemmel kapcsolatos problémának kell lennie. Ennek a problémának meg kell vitatnia a fájlok átnevezésének vagy törlésének szükségességét.

Ne keverje a tartalom hozzáadását vagy módosítását a fájl átnevezésével és törlésével. Minden átnevezett vagy törölt fájlt hozzá kell adni a globális átirányítási fájlhoz. Ha lehetséges, frissítse az átnevezett vagy törölt tartalomra hivatkozó fájlokat, beleértve az esetleges tartalomjegyzékfájlokat is.

Dokumentumok PR-érvényesítési szolgáltatása

A Docs lekéréses kérelem érvényesítési szolgáltatása egy GitHub alkalmazás, amely érvényesítési szabályokat futtat a módosításokon. Az érvényesítési szolgáltatás által jelentett hibákat vagy figyelmeztetéseket ki kell javítania.

A következő viselkedés figyelhető meg:

1. Ön elküld egy PR-t.

2. A lekéréses kérelem állapotát jelző GitHub megjegyzésben az adattárban engedélyezve lesz az "ellenőrzések" állapota. Ebben a példában két ellenőrzés van engedélyezve: "Véglegesítés érvényesítése" és "OpenPublishing.Build":

   

   A build akkor is megfelelhet, ha a véglegesítés ellenőrzése sikertelen.

3. További információkért kattintson a Részletek gombra.

4. A Részletek lapon megjelenik az összes érvényesítési ellenőrzés, azok mellett pedig a problémák kijavításával kapcsolatos információk szerepelnek.

5. Ha az érvényesítés sikeres, a következő megjegyzés kerül a lekéréses kérelembe:

   

Megjegyzés

Ha Ön külső (nem Microsoft-alkalmazott) közreműködő, nem rendelkezik hozzáféréssel a részletes összeállítási jelentésekhez vagy előnézeti hivatkozásokhoz.

A lekéréses kérelem áttekintésekor előfordulhat, hogy a rendszer megkéri, hogy módosítsa vagy javítsa ki az érvényesítési figyelmeztető üzeneteket. A PowerShell-Docs csapata segíthet megérteni az érvényesítési hibákat és a szerkesztői követelményeket.

Következő lépések

A PowerShell Docs stílusútmutatója

További források

A lekéréses kérelmek kezelése