Как мы пишем памятки

Откуда берутся шаги в памятках?

• Страницы приложений в магазинах. App Store и Google Play: кто разработчик, какая нужна версия системы, какая версия приложения актуальна, что приложение умеет по описанию и что разработчик пишет в заметках к версиям.
• Документация и страницы разработчиков приложений. Например, раздел Happ о добавлении подписки, документация INCY для разработчиков и страница выпусков Happ на GitHub — оттуда версия Happ для Android. Названия кнопок берём только отсюда и из заметок разработчика к версиям.
• Справка производителей систем. Apple, Google и Microsoft: пути в настройках и то, как система ведёт себя, когда приложение включает впн. Документ называем по имени и номеру статьи справки.
• Документация протокола. Проект Xray на GitHub и предложение его разработчиков о формате ссылок: что такое VLESS и как устроен ключ, который начинается с vless://.

Пересказы, форумы, чужие инструкции и видео мы источником не считаем. Факт, который есть только там, в памятку не попадает.

Когда источник молчит

Кнопку, которую документация не называет, мы не придумываем. У INCY, например, документация написана для разработчиков, и названий пунктов меню в ней нет. Поэтому в памятке для iPhone сказано, что искать в приложении, а не как точно подписана кнопка.

Приложение, чья страница не открылась ни в одном магазине из тех, где мы искали, в сравнение не попадает, пока не появятся свежие данные. Так 23.09.2026 вышло с v2RayTun. А когда приложения нет только в российском магазине, мы так и пишем и называем магазин другой страны, где оно есть, — как с Happ в сравнении приложений.

Когда сдвигается дата обновления?

• Дата обновления стоит у каждой статьи и меняется, только когда меняется содержание: шаг, путь в настройках, версия приложения или граница. Исправленная опечатка дату не двигает.
• Версии — те, что были в источнике на эту дату: например, INCY 2.6.2 по странице в App Store или Happ для Android 4.4.1 по странице выпусков на GitHub. Они указаны в памятках для iPhone и Android и в проверке для iPhone, а в сравнении приложений — в таблице.
• Сверка. Раз в месяц заново открываем источники опубликованных памяток — магазины, документацию разработчиков, справку систем — и сравниваем с тем, что написано у нас. Нашли расхождение — правим памятку, и дата обновления сдвигается. Каждая сверка попадает в журнал ниже, с расхождениями или без.

Дата, система, версии и строка о проверке на устройстве стоят на странице каждой памятки. Так они выглядят у памятки для iPhone:

Что и когда мы сверяли

Сюда записываем каждую сверку: дату, какие источники открыли и что в них нашли. Где нашлось расхождение, сказано, какую памятку поправили.

Чего мы не делаем?

• Шаги на телефонах и компьютерах мы пока не проходим, поэтому нигде не пишем, что они пройдены на устройстве. Появится такая проверка — у памятки будет строка с датой, моделью и версиями.
• Снимков экрана чужих приложений мы не публикуем. Где без изображения не понять, ставим схему с подписью «схема, не снимок экрана».
• Мест и оценок приложениям не ставим. Сравниваем по фактам — устройство, способ добавить ключ и где приложение не сработает.
• За разработчиков приложений себя не выдаём. INCY, Happ и другие приложения выпускают сторонние команды; мы независимый сервис и с ними не связаны.

Как устроена каждая памятка

1. 1Ответ в первом абзаце: какое приложение, откуда скачать, куда добавить ключ.
2. 2Каждый шаг назван одним действием, чтобы памятку можно было переслать.
3. 3Шаги работают с ключом любого продавца — тем способом, который умеет приложение: в Happ из буфера обмена или по QR-коду, в INCY — по ссылке. Кнопка из кабинета Сверчка — отдельная ветка для наших покупателей.
4. 4Границы: на каких устройствах приложение не поставится и куда ключ не вводится.
5. 5Проверка по порядку на случай, если не подключилось.
6. 6Источники и дата внизу страницы.

Что делать, если экран выглядит иначе?

Версия, для которой написана памятка, указана внизу памятки — сравните её с версией у себя. Какая версия сейчас в магазине, видно на странице приложения в App Store или Google Play, а у Happ для Android — на странице выпусков на GitHub. У вас версия новее — значит, интерфейс мог измениться. Ищите пункт с тем же смыслом: добавление по ссылке или вставку из буфера обмена. Ключ при этом по-прежнему добавляют в приложение, а не в настройки системы.