PlatyPS doesn’t support localized headers.

Issue:

Currently PowerShell cmdlet/ref schema does not allow localization of header text, including H2 texts. This causes the localized ref topics fail publishing to docs.

Request

Docs - Update PowerSehll cmdlet/ref content schema to support localizing H2 titles in markdown files

Current Workaround:

We have to revert the translated H2 headers for all locales back to English in order to pass the build but this requires lots of unnecessary manual work that creates broken experiences for our international customers.

Steps to reproduce

Localize H2 headers such as “Description”, “Examples”, and “Parameters” and do a build

Expected behavior

Build passes successfully

Actual behavior

Build fails.

Failed builds:
---------------https://opbuildstorageprod.blob.core.windows.net/report/2019%5C10%5C14%5Cbf5577a1-a2a2-6319-05ac-9b87e96c60b5%5CCommit%5C201910140856127553-live-sxs%5Cworkflow_report.html?sv=2016-05-31&sr=b&sig=bZOi65PTJjc97VVw6qY%2Bw%2BqgBG%2F48ef0NA6KVIJEZhY%3D&st=2019-10-14T18%3A25%3A01Z&se=2019-11-14T18%3A30%3A01Z&sp=r Error msg sample: 1267 error(s) (1267 System), 1 warning(s) (1 User). Failed to parse exchange-ps/exchange/active-directory/Get-ADServerSettings.md due to :2:(0) '## ÜbersichtÜbersichtSYNOPSIS, please use PlatyPS to do content validation...
Needed feature update: Please update this schema https://raw.githubusercontent.com/PowerShell/platyPS/master/platyPS.schema.md, to enable localization of H2 header texts in PowerShell cmdlet/ref in markdown files. ## SYNOPSIS ## SYNTAX ## DESCRIPTION ## EXAMPLES ## PARAMETERS ## RELATED LINKS

Reference Bug:

Bug 131188I

Screenshot of the issue:

Comments:

Please take a look at the reference bug mentioned above. It has all the detail background information.

Priority

High

Start with platyPS.schema.md and reproduce the reported build using a localized H2 such as “Description” in a cmdlet/ref Markdown file. Trace the validation error for the localized header; done means the schema accepts localized H2 titles and the build passes without reverting them to English.