Редакционная команда
У сайта один автор, и этот же автор проверяет то, что пишет. Эта страница говорит, кто это, что проверяет вычитка и что вы можете проверить сами.
Автор и рецензент
Kostan Proff
Инженер по основной специальности. Пишет руководства, поддерживает расчётный движок и сверяет каждую опубликованную цифру с первоисточником. Код, который выполняет вычисления, открыт, а формулы покрыты модульными тестами, запускаемыми при каждом изменении.
Что вы можете проверить
Арифметика открыта
Код каждого калькулятора лежит в открытом репозитории: вместе с реализованными формулами, модульными тестами, которые сверяют их с известными опубликованными цифрами, и проверками, которые останавливают выпуск со сломанной страницей. Цифры не приходится принимать на веру, и о них не приходится спрашивать.
Почему на этой странице только одно имя
На многих сайтах указаны авторская команда и отдельная команда проверки. Здесь их нет, потому что их нет и в самом деле. Человек, имя которого указано выше, пишет руководства, проверяет арифметику и публикует результат. Если страница говорит, кто её написал, — это и есть тот, кто её написал.
Второе имя легко выдумать, и честного способа это сделать нет. Если сайт говорит, что рецензент что-то проверил, честная версия этого утверждения — человек, который действительно это проверил. Поэтому сайт говорит то, что верно на самом деле, и подкрепляет это тем, что читатель может посмотреть сам: источником каждой цифры, формулой за ней и кодом, который её применяет, — всё это открыто.
Если позже появится внешний рецензент, его имя будет стоять только на тех страницах, которые он действительно проверял, и больше нигде.
Что проверяет вычитка
Перед публикацией руководства рецензент каждый раз проходит по одному и тому же списку:
- Арифметику. Каждая формула сверяется с источником, из которого она взята, а разобранный пример в тексте пересчитывается заново. Там, где цифра встречается в коде, их сравнивают.
- Единицы измерения. Проценты против десятичных дробей, месяцы против лет, доллары против тысяч. Большинство ошибок в финансовом документе — это ошибка в единицах измерения.
- Предельные случаи. Нулевая ставка, нулевой срок, отрицательное значение. Каждый случай проверяется на то, что он даёт осмысленный ответ, а не сообщение об ошибке.
- Формулировки. Страница не должна говорить читателю, что делать. Она объясняет, что значит цифра и от чего она зависит, и на этом останавливается. Руководство, которое рекомендует действие, переписывается.
- Источники. Каждая ссылка открывается, проверяется на утверждение, к которому она относится, и получает дату.
Как используются инструменты для черновиков
Инструменты для черновиков помогают с текстом. Они не решают, что сказано на странице. Каждую цифру, каждую формулу и каждое утверждение пишет или проверяет человек, и ни одна страница не выходит без вычитки, описанной выше. Инструмент, выдавший правдоподобную цифру, — ровно то, ради чего этот процесс и нужен.
Проверка на это не только человеческая. У расчётного движка есть модульные тесты, которые запускаются при каждом изменении и останавливают выпуск, если цифра сдвинулась: график должен в сумме дать взятую сумму, заём — закрыться ровно нулём, а пошаговый прогноз — сходиться с замкнутой формулой при любой периодичности начисления. Фрагмент текста так сломаться не может. Формула — может, и когда это происходит, сборка останавливается.
Даты проверки
У каждого руководства есть дата последней вычитки. Руководство, содержание которого зависит от внешних данных, проверяется не реже двух раз в год; руководство, объясняющее арифметику, — когда меняется формула за ним и в любом случае раз в год. Когда страницу вычитывают, дата сдвигается независимо от того, изменился текст или нет, поэтому дата показывает, когда человек последний раз читал страницу.
Исправления
Исправления вносятся открыто. У исправленной страницы обновляется дата проверки, а само исправление описывается в той ветке переписки, откуда оно пришло. Руководство с неверной цифрой — это дефект вычитки, а не текста, и меняется именно процесс проверки.