Поставила документацію під власний лінтер — побюджетний ліміт рядків на файл, який лише знижується, вимогу індексу та перевірку справжніх шляхів, — який знайшов шість із дев'яти планів, позначених виконаними, попри невідмічені пункти, і чотирнадцять завдань, що блокували кожен коміт, не згаданих у жодному документі.

Ситуація. Репозиторій керує собою письмовими інструкціями — двадцять шість документів, що охоплюють політику якості, систему дизайну, доступність, друк, метадані, переклад і git. Інструкції мають своєрідний взірець занепаду: вони довшають, вони відходять від коду, вони починають посилатися на файли, які перемістилися, і на певному розмірі їх перестають читати. Непрочитане правило не є правилом.

Завдання. Документація потребувала того самого поводження, що й код, — лінтера з межами, які валять, а не радять.

Дія. Вісім політик, кожна механічна. Жорстка стеля довжини документа й м’якша, що попереджає. Пофайловий бюджет рядків, що рухається лише вниз, тож документ може зменшитися й не може вирости назад. Вимога індексу понад певний поріг і індексу розділів понад менший. Правило розташування про те, який документ володіє якою темою. Чинність посилань. Чесність планів — стан, який заявляє план, має відповідати його власним позначкам. Правило, що кожне завдання, яке стереже коміт, названо в якомусь документі. І перевірка справжності шляхів: кожен шлях із каталогом і кожен символ коду, який називає документ, справді існує. Перший прогін був аргументом на користь усієї вправи: шість планів, позначених готовими, які несли непозначені пункти, чотирнадцять завдань, що стерегли кожен коміт і не були названі в жодному документі, три зламані посилання, один осиротілий документ і три мертві шляхи у п’яти документах. Бюджет потім відмовив власному авторові — запис підсумку цієї роботи до документа з розробки виштовхнув його за межу, і саме так з’явився окремий документ, а це і є політика, що працює точнісінько як задумано.

Результат. Двадцять шість документів загальним обсягом приблизно 2 666 дієвих рядків, кожен під бюджетом, що не може зрости, з кожним шляхом і символом, які вони називають, звіреними з деревом. Незручний висновок вартий повторення: чотирнадцять перевірок стерегли кожен окремий коміт, не з’являючись у жодному документі, тож правила, які примусово застосовувала машина, і правила, які читали люди, вже розійшлися.