Документация без боли

Если вы используете Confluence как рабочее пространство, рано или поздно встает вопрос: как правильно работать с файлами. На первый взгляд всё просто — загрузил файл и забыл. Но на практике есть нюансы: версии, отображение, макросы, поиск. Разберёмся системно 👇 Файлы в Confluence — это отдельная сущность, а не просто «картинка в тексте». По сути, это встроенный файловый менеджер с поддержкой версий. Важно понимать: Практически имеет смысл загружать только те файлы, с которыми система умеет работать:...

(спойлер: дело не в лени) Есть один странный парадокс в IT. Все говорят: «Документация — это важно», и те же самые люди через 5 минут: гуглят ошибку и копируют ответ со Stack Overflow. Почему так? Не потому что разработчики ленивые. А потому что документация часто… ну, скажем мягко — не помогает. Типичная документация написана так: “Use the configuration provider to initialize the environment…” Разработчик читает это и думает: «Окей… а где код?» Ему не нужно «как правильно устроен мир». Ему нужно: Если этого нет — он закрывает вкладку...

У большинства команд есть база знаний и почти у всех она не работает. Её пишут, обновляют, переносят в Confluence, а потом туда просто перестают заходить. И дело не в людях. Дело в том, как всё это устроено. Давайте разберёмся. Знакомая ситуация: открываешь базу знаний — и не понимаешь, куда идти. Страницы лежат как попало: дубли, устаревшие инструкции, странная логика разделов. В какой-то момент проще спросить коллегу, чем искать самому. 🍏 Что делать Строить структуру не «как получилось», а под реальные задачи...