«Кто владеет этой страницей?»
Инструментальный ответ изменился: общие папки уступили репозиториям и ownership rules. Организационный вопрос остался. Страница без ответственного владельца продукта со временем превращается в предположение о текущем поведении.
Современная система может лучше показать владение, но не может его изобрести.
«Дублировать или переиспользовать?»
Reuse по-прежнему обменивает согласованность на контекст. Общий warning полезен, когда смысл и жизненный цикл действительно общие. Переиспользование абзаца только потому, что слова похожи, может сделать обе страницы хуже.
Правильная единица reuse определяется смыслом, а не внешним сходством.
«Сколько скриншотов — слишком много?»
Скриншоты дороги при изменениях интерфейса, сложны для локализации и могут быть проблемой для доступности. Но они по-прежнему отлично работают, когда важна пространственная ориентация. Устойчивое правило простое: используйте изображение, когда оно передаёт смысл лучше текста, а существенную инструкцию всё равно оставляйте текстом.
«Кто должен ревьюить документацию?»
Ответ всё ещё множественный. Техническая истина, редакционное качество и продуктовая политика могут требовать разных людей. Одна галочка approval не доказывает все три.
Pull request упрощает маршрутизацию, но ответственность команда всё равно должна определить сама.
«Какой инструмент выбрать?»
Этот вопрос переживает поколения, потому что на самом деле он о контенте, авторах и сопровождении. Сначала требования, затем прототип самых сложных случаев и обязательно путь миграции.
Старые обсуждения полезны там, где показывают проблемы, пережившие несколько технологических волн. Именно их обычно стоит решать на уровне системы.
Практический разбор
Читайте «Старые вопросы о документации, которые удивительно хорошо пережили время» в двух колонках: что определялось технологиями своего времени, а что относилось к самой документационной задаче. Воспроизведите небольшой старый процесс современными средствами — например выпуск release notes, ведение глоссария или подготовку offline-руководства — и отметьте решения, которые остались прежними, хотя носитель полностью изменился.
Ищите устойчивые закономерности, а не только ностальгию:
- как читатель находил нужную информацию;
- как распространялись исправления;
- кто отвечал за точность после публикации;
- какие ограничения старого носителя заставляли работать дисциплинированнее.
Исторический материал полезен тогда, когда помогает яснее увидеть современную проблему. Цель не в том, чтобы вернуть старый workflow, а в том, чтобы отделить долговечные редакционные принципы от инструментов конкретной эпохи.
Короткий редакционный чек-лист
- «Кто владеет этой страницей?». Инструментальный ответ изменился: общие папки уступили репозиториям и ownership rules.
- «Дублировать или переиспользовать?». Reuse по-прежнему обменивает согласованность на контекст.
- «Сколько скриншотов — слишком много?». Скриншоты дороги при изменениях интерфейса, сложны для локализации и могут быть проблемой для доступности.
- «Кто должен ревьюить документацию?». Ответ всё ещё множественный.
