Как использовать инструменты для документации (Confluence)?

Question

Confluence используется как единое пространство для создания, хранения и совместной работы над документацией. Вы создаете страницы, организуете их в иерархические пространства (spaces), используете готовые шаблоны и мощные макросы для вставки таблиц, диаграмм, кода и ссылок на задачи из Jira. Его главные преимущества — это версионность, контроль доступа и легкий поиск.

YeaHub · Accepted Answer

Confluence от Atlassian — это вики-система, ставшая отраслевым стандартом для технической документации.Основные принципы работы в Confluence:Организация контента:Пространства (Spaces): Создавайте отдельные пространства для разных проектов, отделов или продуктов (например, "Space_ProjectX", "Space_HR").Страницы (Pages) и иерархия: Создавайте страницы и организуйте их в древовидную структуру, используя родительские и дочерние страницы.Создание контента:Шаблоны (Templates): Начинайте создание документа с подходящего шаблона (Meeting Notes, Product Requirements, How-to Article).Макросы (Macros): Это "кирпичики" для расширенного форматирования.{code} для вставки подсвеченного синтаксиса.{table-of-contents} для автоматического оглавления.{jira} для отображения списка задач из Jira.{children} для отображения списка дочерних страниц.Совместная работа:Комментарии и инлайн-комментарии: Обсуждайте конкретные части текста.Уведомления (@упоминания): Привлекайте внимание коллег.История версий: Просматривайте, кто и какие изменения внес, и при необходимости откатывайтесь к предыдущим версиям.Пример использования макроса для кода:// В редакторе Confluence вы просто вводите макрос и вставляете код
{code:language=java}
// Пример кода на 1С
Процедура ПриПроведении(Отказ)
    // Алгоритм проведения документа
КонецПроцедуры
{code}Вывод: Confluence эффективен тогда, когда его возможности по структурированию и совместной работе используются осознанно и в полной мере.