Устранение неполадок: симптомы и решения

Статья troubleshooting начинается с того, что видит пользователь, а не с формулировки из интерфейса Happ: медленная скорость, частые обрывы соединения, разряд батареи, некоторые сайты не открываются. Такой вход удобен, когда неизвестно, в чём причина, и тем более неизвестен точный текст ошибки.

Если симптом всё же сводится к конкретному сообщению, например к ошибке при обновлении подписки, статья прямо ссылается на её разбор в разделе errors — вместо «Timeout при добавлении подписки» заново пересказывать то же самое под другим заголовком.

После описания симптома — таблица «причина — как проверить — что сделать»: у одного симптома почти всегда несколько возможных причин, от самой частой до редкой, и таблица помогает быстро отсеять неподходящие. Проверка занимает секунды — посмотреть значение, повторить действие в другой сети, сравнить на другом устройстве.

Если причина не нашлась по таблице, дальше идут шаги диагностики — так же, как в how-to, с ожидаемым результатом на каждом шаге. Статья заканчивается чек-листом: по нему проверяют, что проблема действительно решена, а не просто временно пропала. Часть решений для конкретной платформы вынесена на отдельную страницу раздела solutions, например «Таймаут получения подписки на Windows» — статья troubleshooting ссылается туда, а не повторяет те же шаги внутри себя.

Не каждую проблему можно решить на стороне устройства. Если чек-лист пройден, а симптом остался, и та же проблема повторяется на разных устройствах и в разных сетях одновременно, скорее всего дело не в конфигурации Happ, а в сервере или самой подписке.

В этом случае в статье обычно указано, что стоит сообщить провайдеру: время сбоя, платформу и версию приложения, а также то, что уже проверено по чек-листу. Это ускоряет разбор на стороне провайдера и избавляет от повторного прохождения тех же шагов, которые уже дали результат.

Troubleshooting не пересказывает термины и параметры — если по ходу текста встретилось незнакомое слово, за определением проще заглянуть в глоссарий, а за разбором темы целиком — в wiki.

Если симптом привязан к конкретной сети, а не к приложению в целом — например, обрывы именно в дороге или именно в офисе, — точнее подойдёт сценарий из раздела restricted-network. Профилактика частой проблемы иногда описана как отдельная задача: например, регулярное обновление подписки описано в how-to, а не только как причина в таблице troubleshooting. Статья «Подписка не обновляется» показывает такую связку на практике.