Marketplace Copy Source

August 4, 2026 · View on GitHub

This directory is the source of truth for marketplace descriptions, reviewer notes, and store-shaped listing artifacts.

Store copy must not be generated by truncating README.md, localized README files, or homepage sections. The README files can explain the product in depth; marketplace fields need their own copy that is shorter, clearer, localized, and reviewed for metadata policy risk.

The tone should stay positive and specific. Marketplace copy should describe real capabilities clearly, including supported rich content and export workflows. The policy risk is repeated keyword stuffing, not objective feature description.

Directory Layout

docs/store/
├── README.md
├── schema.md
├── browser-extension/
│   ├── baseline.en.md
│   ├── locales/
│   ├── chrome-web-store/
│   └── edge-add-ons/
├── platform-readme-source/
└── generated/

Source Rules

  • browser-extension/baseline.en.md is the reviewed English baseline for browser extension store copy.
  • browser-extension/locales/*.md contains localized store copy for each submitted locale.
  • browser-extension/chrome-web-store/ contains Chrome Web Store packaging notes and store-shaped source.
  • browser-extension/edge-add-ons/ contains Microsoft Edge Add-ons packaging notes and store-shaped source.
  • platform-readme-source/ is for platform-specific README source drafts.
  • generated/ is for reproducible generated artifacts only. Do not hand-edit generated files.

Policy Rules

  • Keep reusable browser extension descriptions browser-neutral. Do not name Chrome or Edge in the shared long description body.
  • Use store-specific notes only where a store requires marketplace names or reviewer guidance.
  • Use one organized feature inventory. Do not repeat the same supported-engine or supported-format list in the headline, opening paragraph, feature list, FAQ, and closing summary.
  • Every submitted locale must be written in the target local language. Do not submit English fallback text under another locale.
  • Official names such as docu.md, Markdown, DOCX, PDF, HTML, Chrome Web Store, Microsoft Edge Add-ons, VS Code, and GitHub may remain in their normal spelling.

Validation

Before using these files for store submission, run keyword-density and fallback checks from plans/market-readme-rewrite-plan.md.