File Specifications
All files must be UTF-8 encoded. The English
README.md always stays in the plugin root; every other language goes inside a readme/ subdirectory.
Recommended Structure
Keep READMEs concise, under ~500 words. The Marketplace detail page surfaces the README directly, so optimize it for someone evaluating whether to install:How the Marketplace Picks a Language
When a visitor opens your plugin’s detail page, the Marketplace looks for a README matching their UI language. If a match exists in thereadme/ directory, it renders that file. Otherwise it falls back to the English README.md.

Language codes are matched exactly:
README_zh_Hans.md serves Simplified Chinese only; Traditional Chinese users see the English fallback.