Работа с Wiki Docs

Инструмент Wiki Docs предназначен для удобного администрирования документации: для создания, удаления, восстановления страниц документов.

Создание страницы

Создавать страницы могут пользователи с ролями Администратор Сервиса и Администратор ГИС. Документация создается на уровне проекта.
Чтобы создать страницу:
  1. Авторизуйтесь под своей учетной записью и зайдите в нужный проект.
  2. Перейдите на страницу Wiki с помощью соответствующего пункта меню.
    New page

    Увеличить

  3. В правом верхнем углу нажмите New Page. Откроется форма создания страницы.
  4. Заполните поля формы:
    Создание страницы

    Увеличить

    Номер поляОписание
    1
    Название страницы. В этом поле так же указывается полный путь до страницы в структуре документа
    2
    Формат текста. По умолчанию — Markdown. Доступные значения: RDoc, AsciiDoc, Org
    3
    Область для наполнения контентом
    4
    Автоматически генерируемое техническое сообщение
  5. Нажмите Create page. Откроется новая страница. В боковом меню будет отображаться иерарахия страниц.
    Отображение страницы

    Увеличить

Редактирование страницы

Для страницы можно редактировать следуующие поля:
  • название и путь (поле Title);
  • формат (поле Format);
  • контент (блок Content).
Чтобы редактировать страницу:
  1. Выберите нужную страницу в меню справа.
  2. На странице просмотра нажмите на кнопку редактирования с пиктограммой «карандаш» в правом верхнем углу (Карандаш).
  3. На открывшейся странице редактирования внесите все требуемые изменения.
  4. Сохраните изменения, нажав Save changes.

История изменений страниц

Чтобы просмотреть историю изменений страницы:
  1. Выберите страницу в меню справа.
    Page History

    Увеличить

  2. Нажмите Page History в правом верхнем углу. Откроется область просмотра истории изменений страницы.
    Область просмотра истории изменений страницы

    Увеличить

    На странице отображается следующая информация:
    • Page version — версия страницы;
    • Author — автор изменений;
    • Changes — тип изменений, краткое описание что было изменено;
    • Last update — когда были внесены правки;
    • Actions — доступные действия.

Восстановление версии страницы

Любую версию документа можно восстановить. Сделать это можно двумя способами.
Первый способ восстановления страницы:
  1. Откройте страницу Истории изменений.
  2. Выберите необходимую версию страницы.
  3. Нажмите кнопку revert в строке с нужной версией.
  4. В диалоговом окне подтвердите действие.
    Диалоговое окно

    Увеличить

Второй способ восстановления страницы:
  1. Откройте страницу Истории изменений.
  2. Выберите необходимую версию страницы.
  3. Нажмите на требуемую версию страницы. Откроется выбранная версия страницы.
    Версии страницы

    Увеличить

  4. Нажмите Revert page в правом верхнем углу рабочей области.
    Revert page

    Увеличить

  5. В диалоговом окне подтвердите действие. Откроется восстановленная версия страницы.

Согласование страницы

Чтобы настроить согласование для страницы:
  1. Откройте страницу, для которой необходимо добавить согласующих, в режиме просмотра.
  2. Нажмите Page don’t need approval.
    Page don’t need approval

    Увеличить

  3. Добавьте согласующих. Для этого нажмите кнопку с пиктограммой "крестик" ((Крестик)) и введите пользователей в строке поиска.
    Обратите внимание, что добавить согласующих можно только в те статьи, автором которых вы являетесь.
Ввод необходимых пользователей

Увеличить

Статус на странице изменится на Not approved.
Изменение статуса

Увеличить

Если пользователь указан как согласующий, то при открытии страницы и нажатии на Status: not approved будет отображена кнопка согласования.
Кнопка согласования

Увеличить

Если страница согласована всеми ответственными, то ее статус изменится на Status: approved.
Изменение статуса на Approved

Увеличить

Подтверждение можно отозвать, повторно нажав на Status: not approved (если не все заявленные согласующие подтвердили) или Status: approved (если все согласующие подтвердили контент) и кнопку Unapprove.
Отзыв подтверждения

Увеличить

Для изменения списка согласующих необходимо вызвать список ответственных.

Связывание страницы вики и задачи

Любую страницу можно связать с любым типом задач. Сууществует два способа создания связи между ними:
  • добавление задачи в интерфейсе страницы;
  • добавление страницы в интерфейсе задачи.

Добавление задачи в интерфейсе страницы

Для добавления задачи:
  1. Откройте необходимую страницу Wiki.
  2. В блоке Linked issues нажмите Add.
    Блок Linked issues

    Увеличить

    Откроется строка поиска сущности для связи.
    Строка поиска сущности

    Увеличить

  3. В поисковой строке введите название необходимой задачи. Достаточно ввести хотя бы один символ, чтобы сформировался список предложений по заполнению.
    Поиск задачи

    Увеличить

    После выбора задача отобразится в поисковой строке.
    Отображение задачи

    Увеличить

    Добавилять можнон любое количество задач для связывания со страницой.
  4. Подтвердите установкку связи страницы с выбранными задачами - нажмите Add.
    Создание связи с выбранной задачей

    Увеличить

Связанные сущности отображаются в панели Linked Issues.
Связанные сущности в блоке Linked issues

Увеличить

При переходе в связанную задачу достаточно кликнуть на нужную задачу. Связанная страница будет отображаться в соответствующей вкладке в основной части страницы.
Отображение связанной задачи

Увеличить

Добавление страницы в интерфейсе задачи

Для добавления страницы:
  1. Перейдите в задачу, которую необходимо связать со страницей.
  2. В основной части страницы задачи перейдите на вкладку __ Wiki Pages__.
    Вкладка Wiki pages

    Увеличить

  3. В открывшемся интерфейсе нажмите Add и выберите пункт Add an existing wiki page.
    Добавление существующей Wiki страницы

    Увеличить

    Откроется окно поиска необходимой страницы.
    Окно поиска страницы

    Увеличить

  4. В поле поиска начните вводить название страницы. Система предложит варианты по частичному совпадению.
    Поиск добавляемой страницы

    Увеличить

  5. Выберите страницу и нажмите Add.
    Добавление Wiki страницы

    Увеличить

    Страница будет отображена в списке связанных.
    Отображение связанной страницы

    Увеличить

Cвязанные объекты отображаются в блоке Linked Issues.
Отображение страницы в блоке Linked Issues

Увеличить

Предыдущий раздел
Добавление пользовательских полей
Следующий раздел
1.22 Управление релизами
Была ли страница полезной?