#dusk $DUSK @Dusk Я раньше думал, что проблемы с документацией — это в основном неудобство для разработчиков.

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

Этот разрыв может быть гораздо более серьёзным, чем опечатка.

Меня привлекло именно по этой причине «Питуитори» от Dusk.

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

Я нахожу это удивительно актуальным для инфраструктуры блокчейна.

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

Если эти допущения незаметно расходятся с реализацией, проблема может оставаться невидимой до тех пор, пока кто-то не полагается на неверную версию реальности.

Что мне нравится в Pituitary, так это то, что он рассматривает это как задачу согласованности, а не просто как проблему документации.

И Dusk действительно создал его, потому что команда сама столкнулась с этой проблемой по мере роста набора спецификаций и репозиториев.

Возможно, зрелая инфраструктура — это не только про написание более качественного кода.

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

Звучит менее захватывающе, чем новая функция протокола.

Но честно говоря, это может быть не менее важно.