Документацию пишут один раз — в первую неделю после настройки сервера, когда всё ещё свежо в памяти и хочется зафиксировать, «как это работает». Потом происходит десяток мелких правок конфига, три инцидента, смена версии PostgreSQL и один уволившийся сотрудник, который единственный помнил, зачем nginx слушает на нестандартном порту. Документ остаётся лежать на месте, но перестаёт быть картой местности — он описывает систему, какой она была полгода назад. Хуже, что устаревшая документация не нейтральна: она не просто бесполезна, она активно вводит в…
Подробнее →