Проверьте каждое обещание

Обещание на сайте и программа у вас на столе расходятся легко: текст пишут в одном месте, код в другом. Без сверки вы узнали бы о расхождении уже после покупки.

Поэтому у каждого обещания есть строка, привязанная к коду, который его выполняет. Сегодня таких строк 97, и разложены они по семи частям продукта.

• Поддержка

  Обещание поддержки на вашем тарифе указывает на ту службу, куда правда попадёт обращение.

• Отпечаток > Изменить значения

  Что вы видите в окне «Отпечаток», то и получает профиль: правила на экран и на запуск одни.

• Массовые действия

  Строка в тарифе указывает на тот экран, где вы эти действия и делаете.

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

В среднем столбце стоит путь, который вы откроете, а не папка и не название части программы. В правом проверка, которую вы запустите у себя, и краснеет она тогда, когда поведение ломается.

1. 1

   Прочитать обещание

   Возьмите строку про то, что прокси покрывает весь трафик профиля.

2. 2

   Открыть файл

   Откройте apps/desktop/src/lib/forkEngine.js: правило для движка записано там.

3. 3

   Запустить проверку

   Запустите apps/desktop/test/proxy-covers-https.js: она смотрит, что именно уходит через прокси.

Сегодня обещаний 97, и каждое ниже приведено из файла слово в слово. Путь рядом с каждым ведёт в код от корня репозитория, и каждый из них существует.

Разброс выбран нарочно: движок, сеть, команда, деньги, поддержка, программа, языки. Остальные строки вы прочитаете точно так же, как эти.

Документ, который никто не исполняет, гниёт за месяц, а этот сгнил бы быстрее прочих: именно тут удобнее всего тихо поправить неудобную правду. Поэтому мы проверяем и сам этот список.

Утверждений у неё семь. Четыре о том, что названное в строке существует, три труднее.

• Вы всегда видите весь список

  Не меньше тридцати строк, иначе поломка чтения выглядела бы как список без единой беды.

• Каждое обещание называет живой файл

  Путь ведёт от корня репозитория и обязан существовать на диске.

• Каждое обещание называет живую проверку

  То же правило для правого столбца.

• Каждая проверка правда идёт в прогоне

  Её имя обязано стоять в команде, которой запускается своя часть.

• Проверка достаёт до файла, который стережёт

  Самое трудное из семи, и об этом глава ниже.

• Пустых мест нет ни в одной строке

  И файл не совпадает с проверкой: обещание не может быть собственным доказательством.

• Самые дорогие обещания названы поимённо

  Поддержка, отпечаток, прокси, приглашение, платный тариф, цены.

Файл жив, проверка жива, прогон зелёный, а стережёт она совсем другое. На экране об этом не говорит ничего, и потому это самая тихая поломка из всех.

Поэтому проверка обязана доставать до своего файла. Упоминание файла в примечании за исполнение не считается.

• По имени

  Сама проверка называет путь или имя файла, а слишком общий корень имени не засчитывается.

• По имени пакета

  Общий пакет подключают по имени @armanos/shared, и это имя засчитывается.

Написанная проверка, которую не зовёт ни одна команда, создаёт чувство, что место прикрыто. Это хуже пустого места: туда перестают возвращаться.

Поэтому первой во всём прогоне идёт проверка, которая не исполняет ни строчки продукта. Она сличает файлы проверок на диске с тем, что команды действительно зовут.

• Проверка на диске, которую не зовёт ни одна команда

  Названа в отказе вместе с областью, к которой относится.

• Команда, зовущая файл, которого нет

  Мёртвый путь в команде прогона выглядит ровно как покрытие.

• Образец, не находящий ни одного файла

  Пустой образец гоняет ноль файлов и печатает зелёное.

• Область, которой нет в корневой команде

  Тогда «всё зелено» означает «зелено не всё».

• Проверка, дописанная после итоговой строки

  Она исполняется, печатается и в счёт не идёт.

Число автоматических проверок на этой странице сосчитано, а не написано пальцем. Оно приезжает с зелёного прогона трёх настоящих наборов.

Красный прогон не даёт странице ничего: она осталась бы с прежним числом, а не с приукрашенным. Цены и нормы этой дорогой не идут вовсе, потому что таблица тарифов берёт их из того же пакета, по которому программа решает, что вам разрешено.

Зелёная проверка, которая не умеет покраснеть, не стоит ничего. Способ один и он скучный: сломайте само поведение ровно так, как оно ломается на самом деле, запустите проверку и убедитесь, что покраснела она по той самой причине.

Прочитать красное сообщение важно не меньше, чем его увидеть. Красное не по той причине не доказывает ничего, и ничего не доказывает проверка, чьи утверждения стоят ниже её собственной итоговой строки.

1. 1

   Сломать

   Верните дефект в файл продукта ровно тем способом, каким он случается.

2. 2

   Запустить проверку

   Она обязана покраснеть, и сообщение обязано назвать настоящую причину.

3. 3

   Прочитать сообщение

   Красное не по той причине не доказывает ничего.

4. 4

   Вернуть

   Поставьте код на место и убедитесь, что снова зелено.

Здесь не только то, что работает: целиком названы и два места, где измерение не получилось. WebGPU на Windows никем не проверен, потому что на арендованной машине нет видеокарты, и Chromium выключает саму возможность до всякого выбора поставщика.

Голосов синтеза речи на Linux ноль, и ноль здесь равен норме площадки. У настоящего Chrome на Linux их тоже нет, а с доводом запуска, открывающим системный путь, их 13363, и столько не бывает ни на одной живой машине.

Этот список заодно говорит, чего мы не продаём. Если у вещи нет строки, это не обещание, и рассчитывать на неё не стоит.

Про четыре такие вещи спрашивают чаще всего, поэтому они названы здесь. У каждой записано то состояние, в котором она есть сегодня, а не то, к которому идёт.

• Оплата картой

  Касса написана и без ключей бездействует, поэтому платный тариф вам выдают рукой. apps/server/src/billing/stripe.service.ts.

• Подпись и нотаризация

  Усиленная среда и права доступа заданы, сертификата нет, поэтому система предупредит вас при первом запуске. apps/desktop/electron-builder.yml.

• Оферта и правила возврата

  Не написаны. Нужны для приёма денег, а не для работы программы.

• Перепродажа прокси

  Заказ это записанное намерение: денег с вас не берут и к поставщику не ходят. apps/server/src/proxy-store/proxy-store.service.ts.