Коротка відповідь
Поясніть, кому допомагає розширення, що робить користувач і що означає результат. Показуйте справжній інтерфейс і важливі межі поруч з обіцянкою. Оптимізація має поліпшити відповідність завдання й продукту; вона не гарантує рейтинг, схвалення чи популярність.
LocaleStress — конкретний приклад: синтетично збільшує текст для виявлення потенційних проблем макета. Він не перекладає сторінку й не доводить правильність перекладеного інтерфейсу. Це слід пояснити до встановлення, а не лише в довідці.
Практичні кроки реалізації
- Почніть одним реченням про завдання й результат. Замініть «найкращий інструмент продуктивності» конкретною дією. Уникайте повторів ключових слів і сторонніх назв.
- Далі опишіть перший запуск: підтримувана сторінка, виклик, вибір операції й перегляд. Вимоги облікового запису чи оплати пояснюйте лише за їхньої наявності.
- Вибирайте знімки для різних питань. Для LocaleStress керування, вимірювання, експорт та історія пояснюють окремі можливості. П’ять майже однакових екранів менш корисні за свідому послідовність.
- Дотримуйтеся поточних специфікацій і переглядайте оригінали. Обрізання помилки чи малювання відсутнього UI може вводити в оману навіть за правильних розмірів.
- Узгодьте приватність і межі з пакетом. Якщо експорт включає метадані, поясніть вибір. Якщо фрейми, Shadow DOM чи RTL непідтримувані, не натякайте на їхнє покриття.
- Відокремте доступні й майбутні версії. Примітки імпорту розрізняють опублікований LocaleStress 0.3.0 та pending/draft пакети інших розширень. Попередній перегляд у портфоліо не доводить доступність встановлення.
Ведіть журнал змін опису й оцінюйте реальні питання відвідувачів. За наявності показів і встановлень порівнюйте подібні періоди та інші зміни; не приписуйте кожну різницю редагуванню назви.
Приклад реалізації
Структурований запис пов’язує твердження з доказами. Це редакторський приклад, а не payload Store API.
{
"claim": "Find potential layout problems caused by longer text",
"firstUse": ["Open a regular HTTP(S) page", "Invoke the extension", "Run expansion", "Review findings"],
"limits": ["Synthetic text, not translation", "Visual confirmation required", "Top-frame light DOM"],
"evidence": ["Run controls screenshot", "Report comparison screenshot"],
"publicVersion": "0.3.0"
}
Перевірте поля за продуктом і публічним описом. Для справжньої зміни збережіть точний текст і зображення, щоб наступний перегляд бачив змінені твердження. Не видавайте заплановану функцію за доказ.
Компроміси та альтернативи
Короткий опис допомагає перегляду, повний — оцінці меж. Основне завдання ставте першим, подробиці нижче. Локалізації перевіряйте за змістом і підписами, а не заміною ключових слів у рекламному шаблоні.
Поширені помилки
- Гарантувати рейтинг, схвалення чи результат.
- Використовувати сторонні ключі або недоступні функції на знімках.
- Називати синтетичне збільшення доказом правильного перекладу.
- Плутати draft із публічною доступністю.
Контрольний список випуску
- Перше речення називає конкретне завдання.
- Знімки відповідають доступному продукту.
- Межі й приватність узгоджені з пакетом.
- Версія й посилання встановлення перевірені.
- Цілі змін спираються на питання чи дані, не вигадані метрики.
Поширені запитання
Чи повторювати запит у кожному абзаці?
Ні. Чітко відповідайте на завдання й використовуйте терміни для пояснення. Повторення не створює доказів.
Чи показувати майбутній UI?
Лише з явним контекстом без враження поточної встановленої версії. Для встановлення віддавайте перевагу доступним функціям.
Що змінити спочатку?
Перше неточне твердження, потім послідовність першого запуску. Оцінюйте розуміння до переслідування необґрунтованого рейтингу.
Первинні джерела
Пов’язані посібники та приклади
Потрібно реалізувати це у вашому продукті?
Перегляньте відповідні приклади продуктів або поділіться контекстом розробки вебзастосунку, розширення Chrome, API чи SaaS.