# Поставила документацію під власний лінтер — побюджетний ліміт рядків на файл, який лише знижується, вимогу індексу та перевірку справжніх шляхів, — який знайшов шість із дев'яти планів, позначених виконаними, попри невідмічені пункти, і чотирнадцять завдань, що блокували кожен коміт, не згаданих у жодному документі. серпень 2026 **Ситуація.** Репозиторій керує собою письмовими інструкціями — двадцять шість документів, що охоплюють політику якості, систему дизайну, доступність, друк, метадані, переклад і git. Інструкції мають своєрідний взірець занепаду: вони довшають, вони відходять від коду, вони починають посилатися на файли, які перемістилися, і на певному розмірі їх перестають читати. Непрочитане правило не є правилом. **Завдання.** Документація потребувала того самого поводження, що й код, — лінтера з межами, які валять, а не радять. **Дія.** Вісім політик, кожна механічна. Жорстка стеля довжини документа й м'якша, що попереджає. Пофайловий бюджет рядків, що рухається лише вниз, тож документ може зменшитися й не може вирости назад. Вимога індексу понад певний поріг і індексу розділів понад менший. Правило розташування про те, який документ володіє якою темою. Чинність посилань. Чесність планів — стан, який заявляє план, має відповідати його власним позначкам. Правило, що кожне завдання, яке стереже коміт, названо в якомусь документі. І перевірка справжності шляхів: кожен шлях із каталогом і кожен символ коду, який називає документ, справді існує. Перший прогін був аргументом на користь усієї вправи: шість планів, позначених готовими, які несли непозначені пункти, чотирнадцять завдань, що стерегли кожен коміт і не були названі в жодному документі, три зламані посилання, один осиротілий документ і три мертві шляхи у п'яти документах. Бюджет потім відмовив власному авторові — запис підсумку цієї роботи до документа з розробки виштовхнув його за межу, і саме так з'явився окремий документ, а це і є політика, що працює точнісінько як задумано. **Результат.** Двадцять шість документів загальним обсягом приблизно 2 666 дієвих рядків, кожен під бюджетом, що не може зрости, з кожним шляхом і символом, які вони називають, звіреними з деревом. Незручний висновок вартий повторення: чотирнадцять перевірок стерегли кожен окремий коміт, не з'являючись у жодному документі, тож правила, які примусово застосовувала машина, і правила, які читали люди, вже розійшлися. --- - Роль: Технічний продакт‑менеджер - Категорії: [Автоматизація та CI/CD](https://engineer.company/uk/categories/automation/), [Тестування та QA](https://engineer.company/uk/categories/testing/), [Python](https://engineer.company/uk/categories/python/), [Технічне лідерство](https://engineer.company/uk/categories/technical-leadership/), [Управління проєктами](https://engineer.company/uk/categories/project-management/), [Документація](https://engineer.company/uk/categories/documentation/) - Послуги: [Технічне лідерство та консалтинг](https://engineer.company/uk/services/technical-leadership/), [Управління проєктами (Agile)](https://engineer.company/uk/services/project-management/), [Технічна документація](https://engineer.company/uk/services/technical-documentation/)