#dusk $DUSK @Dusk ......Я обычно смотрю на код протокола, когда речь идет о больших вещах. На этот раз меня привлекло небольшое изменение в документации.
Dusk изменил то, как его документация валидирует и публикует sitemap.
Сначала это выглядит как рутинная уборка:
команда npm run build превратилась в проверочный процесс, который собирает сайт, запускает тесты, а затем проверяет результат.
Но более интересное изменение происходит с sitemap.xml.
Вместо того чтобы поддерживать отдельную статическую карту сайта, сборка теперь берет сгенерированный Astro sitemap-index.xml и создает стандартный sitemap.xml как алиас.
Звучит скучно.
На самом деле это решает полезную инфраструктурную проблему.
Представьте, что вы меняете адресную систему здания. Здание уже генерирует правильную внутреннюю схему, но внешние посетители по-прежнему ожидают найти вход по знакомому адресу. Вместо того чтобы поддерживать две карты, которые могут разойтись, сборка создает знакомый адрес из сгенерированного источника.
Тесты поддерживают именно эту мысль.
#Dusk теперь проверяет, что сгенерированный sitemap корректен, и что обычный sitemap.xml в точности ему соответствует. Так что изменение в документации может провалить верификацию, если эта связь нарушится.
Что мне здесь нравится — это инженерный подход.
Коммит не добавляет какое-то эффектное изменение протокола. Он уменьшает вероятность того, что документационная инфраструктура незаметно станет несогласованной по мере развития сайта.
И это важнее, чем может показаться.
Для технического проекта документация — часть интерфейса, от которого зависят разработчики, операторы и автоматизированные инструменты.
Сломанная ссылка, устаревшая карта сайта или неполная сборка не подрывают консенсус, но все равно может создавать трение вокруг всего, что построено поверх протокола.
Небольшой коммит. Очень неглянцевая проблема.
Но именно такие детали часто показывают, насколько серьезно команда относится к инфраструктуре вокруг основного продукта.
И вот что я нашел интересным в этом изменении Dusk.
$ACE $RED #ChinaJulyOutputRetailInvestmentAllMiss #CMESeptemberHikeOddsFallTo30.6% #CryptoStartupsRaise$11.2BInH1 #EthereumFoundationLaunchesGlamsterdamTestnet