Označování v GitHubu

Tento článek dokumentuje, jak označujeme problémy a žádosti o přijetí změn v úložišti PowerShell-Docs. Tento článek je navržený tak, aby byl pracovní pomůckou pro členy PowerShell-Docs týmu. Tyto informace zde publikujeme, abychom zajistili transparentnost procesů pro naše veřejné přispěvatele.

Popisky mají vždy název a popis, přičemž oba mají předponu odpovídající jejich typu.

Popisky oblastí

Popisky oblastí identifikují části PowerShellu nebo dokumentaci, ke které problém souvisí.

Označení	Související obsah
area-about	Články about_* .
area-archive	Modul Microsoft.PowerShell.Archive.
area-cim	Modul CimCmdlets.
area-community	Komunitní projekty, včetně průvodce přispěvatele a měsíčních aktualizací
area-conceptual	Koncepční články (ne cmdlet reference).
area-console	Hostitel konzoly
area-core	Modul Microsoft.PowerShell.Core.
area-crescendo	Modul Crescendo.
area-debugging	Ladění PowerShellu
area-diagnostics	Modul Microsoft.PowerShell.Diagnostics.
area-dsc	Konfigurace požadovaného stavu PowerShellu
area-editorsvcs	Služby editoru PowerShellu.
area-engine	Stroj PowerShellu.
area-error-handling	Zpracování chyb v PowerShellu
area-experimental	Experimentální funkce PowerShellu
area-gallery	Galerie PowerShell
area-helpsystem	Služby nápovědy, včetně pipeline a cmdletů *-Help.
area-host	Modul Microsoft.PowerShell.Host.
area-ise	Prostředí PowerShell ISE.
area-jea	Funkce Just Enough Administration
area-language	Syntaxe a klíčová slova PowerShellu.
area-learn	Strukturovaný obsah školení pro PowerShell.
area-localaccounts	Modul Microsoft.PowerShell.LocalAccounts.
area-localization	Problémy s lokalizací nebo příležitosti k obsahu
area-management	Modul Microsoft.PowerShell.Management.
area-native-cmds	Použití nativních příkazů v PowerShellu
area-omi	Open Management Infrastructure & CDXML.
area-ops-issue	Sestavení a vykreslení obsahu na webu
area-other	Různé moduly.
area-overview	Oddíl přehledu v koncepčním obsahu
area-packagemanagement	Modul PackageManagement.
area-parallelism	Obsah zahrnující paralelní zpracování, jako je použití ForEach-Object nebo úloh PowerShellu.
area-platyps	PlatyPS modul.
area-portability	Kompatibilita mezi platformami
area-powershellget	Modul PowerShellGet.
area-providers	Zprostředkovatelé PowerShellu
area-psreadline	Modul PSReadLine.
area-release-notes	Poznámky k verzi PowerShellu
area-remoting	Funkce vzdáleného řízení PowerShellu a cmdlets.
area-scriptanalyzer	Modul PSScriptAnalyzer.
area-sdk-docs	Koncepční dokumentace pro sadu PowerShell SDK.
area-sdk-ref	Referenční dokumentace k rozhraní .NET API pro sadu PowerShell SDK.
area-security	Modul Microsoft.PowerShell.Security a koncepty zabezpečení obecně.
area-setup	Instalace a konfigurace PowerShellu
area-threadjob	Modul ThreadJob.
area-utility	Modul Microsoft.PowerShell.Utility.
area-versions	Problémy s správou verzí dokumentace
area-vscode	Rozšíření VS Code PowerShellu
area-wincompat	Funkce Kompatibility systému Windows.
area-wmf	The Windows Management Framework.
area-workflow	Funkce pracovního postupu Windows PowerShellu

Štítky problémů

Štítky problémů rozlišují jednotlivé záležitosti podle účelu.

Označení	Kategorie problému
issue-doc-bug	Chyby nebo nejednoznačnosti v obsahu
issue-doc-idea	Žádosti o nový obsah
issue-kudos	Pochvalu, pozitivní zpětnou vazbu nebo poděkování místo pracovních položek
issue-product-feedback	Zpětná vazba nebo problémy se samotným produktem
issue-question	Otázky ohledně podpory

Prioritní popisky

Popisky prioritizace určují, které pracovní položky je třeba zpracovat před ostatními. Tyto popisky se používají jenom v případě, že je potřeba spravovat velké sady pracovních položek.

Označení	Úroveň priority
Pri0	Nejvyšší
Pri1	Vysoko
Pri2	Středně
Pri3	Nízká

Štítky projektu

Štítky projektu ukazují, s jakým probíhajícím projektem na GitHubu je pracovní položka spojena. Tyto popisky slouží k automatickému přidávání pracovních položek do projektu při vytváření.

Označení	Projekt
project-quality	Projekt zlepšování kvality

Kvalitní štítky

Popisky kvality kategorizují pracovní položky pro snahu o zlepšení kvality.

Označení	Zlepšení
quality-aliases	Ujistěte se, že jsou zdokumentované aliasy cmdletů.
quality-format-code-samples	Zajistěte správnou velikost písmen, délku řádku a další formátování v ukázkách kódu.
quality-format-command-syntax	Zajistěte správné velikosti a formátování syntaxe příkazů.
quality-link-references	Ujistěte se, že odkazy v koncepčních dokumentech jsou definované jako číslované odkazy.
quality-markdownlint	Ujistěte se, že obsah dodržuje pravidla markdownlintu.
quality-spelling	Zajištění správného psaní písmen a pravopisu pro slova

Popisky stavu

Popisky stavu označují, proč byla pracovní položka uzavřena nebo neměla být sloučena. Stavové štítky jsou problémům přiřazeny pouze v případech, kdy jsou uzavřeny bez souvisejícího PR.

Označení	Stav
resolution-answered	Uzavřeno na základě stávající dokumentace
resolution-duplicate	Uzavřeno jako duplicitní problém
resolution-external	Uzavřeno zákazníkem nebo externím zdrojem
resolution-no-repro	Zadaný problém nelze reprodukovat
resolution-refer-to-support	Uzavřeno a odkázáno na podporu komunity nebo produktů
resolution-wont-fix	Uzavřeno, nebude opraveno

Štítky značek

Popisky značek přidávají pro pracovní položky nezávislý kontext.

Označení	Účel
in-progress	Někdo aktivně pracuje na položce
go-live	Pracovní položka souvisí s konkrétní verzí.
doc-a-thon	Pracovní položka souvisí s dokumentatonem.
up-for-grabs	Každý přispěvatel může dobrovolně vyřešit pracovní položku.
hacktoberfest-accepted	PR je přijata pro zahrnutí do #hacktoberfest
hacktoberfest-candidate	Pull request je kandidátem na začlenění do #hacktoberfest
needs-triage	Aby se na problému mohlo pracovat, musí být nejprve tříděn týmem.
code-of-conduct	Uzavřeno kvůli spamu, trollingu nebo porušení pravidel chování
do-not-merge	PR nemá být sloučena.

Štítky čekání

Popisky čekání označují, že pracovní položku nelze vyřešit, dokud nebude splněna externí podmínka.

Označení	Čekání na
hold-for-pr	Upstream PR ke sloučení
hold-for-release	Upstreamový produkt k vydání
needs-investigation	Čekání na člena týmu, aby provedl ověření nebo výzkum.
needs-more-info	Další podrobnosti nebo objasnění od autora pracovní položky
needs-response	Odpověď od autora pracovní položky
review-shiproom	Diskuze o Shiproomu s týmem PowerShellu