XWiki: лучшая практика

Вводная информация

Лучшая практика (англ. Best practice) — формализация уникального успешного практического опыта. Согласно идее лучшей практики, в любой деятельности существует оптимальный способ достижения цели, и этот способ, оказавшийся эффективным в одном месте, может оказаться столь же эффективным и в другом. 

Цель системы лучших практик — обеспечение возможности обнаружения и использования того, что уже существует.

В данном разделе будут освещаться различные возможности XWiki и варианты их применения

Теги и тегирование документов (страниц)

Тег (англ. tag — «ярлык, этикетка, бирка; метить») — метка как ключевое слово, в более узком применении идентификатор для категоризации, описания, поиска данных и задания внутренней структуры. (по материалам Википедии)

Описание

Для любой страницы XWiki можно добавить тег (метку) или несколько тегов. Теги в Вики служат как инструмент для группирования сходных (относящихся к одному предмету) страниц по одному или нескольким ключевым словам. Тег (метка) представляет из себя ключевое слово (обычно состоит из одного слова), приведенное к стандартной форме (существительное , им. падеж, единственное или множественное число).

Для поиска страниц по тегам используется специальный аггрегатор - "облако тегов". 

Облако тегов, Облако меток, или Облако ключевых слов (англ. tag cloud, wordle) — визуальное представление списка ярлыков (или категорий). Частота упоминаний, поисков, ссылок в интернете с определённого сайта неких слов, терминов, имён, отображается в специальной области в виде изображения этих слов в формате гиперссылок. Размер изображения тем больше, чем чаще использовался данный тег (слово, термин или имя). (по материалам Википедии)

Использование системы тегов для страниц в XWiki:

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

Применение

Для любой страницы в XWiki могут быть задан один тег или несколько тегов. Теги подбираются на основе содержимого (того, о чем говорится на странице) создаваемой страницы. Предлагаем воспользоваться следующей методикой для выделения тегов (ключевых слов страницы). 

• При определении ключевых слов используйте принцип "от общего - к частному": попробуйте выделить общие моменты, которым может иметь отношения создаваемый вами документ. 
• Определите к какому типу информации относится создаваемая страница: это может быть документация, перечень, регламент, схема, список, информация, новость или любые другие категории.
• Определите к какой области информации относится создаваемая страница: это может быть название Продукта, Папка инструкций, Область знаний и т.п.
• Оцените содержимое вашей страницы с позиции пользователя*: определите, какую полезную информацию может почерпнуть другой пользователь и как ее использовать в дальнейшем.
• Воспользуйтесь уже имеющимися тегами: попробуйте найти нужную метку среди уже заданных (другими пользователями) в системе. Список тегов высвечивается в всплывающей подсказке. 
• Задавать теги для всех страниц не обязательно: cтраница может иметь один тег, несколько тегов, либо не иметь тегов вообще.

Примеры

• Документ/Страница: Руководство Пользователя XWiki
  • Документ относится к руководству пользователя: возможные теги - "руководство", "инструкция". 
  • Документ относится к программному продукту XWIKI: возможные теги - "XWiki".
  • Документ создан для пользователей Базы Знаний с целью обучения: возможные теги -  "пользователь", "обучение".
• Документ/Страница: Вексельная касса  (в составе электронной документации по SAP)
  • Документ относится к документации: возможные теги - "документация", "инструкция"
  • Документ относится к программному обеспечению SAP:  возможный тег - "SAP"
  • Документ относится к разделу  Бухгалтерский учет и отчетность: возможные теги "бухгалтерия", "отчеты", "FI" (префикс доков) 
  • Документ относится к разделу Вексельная касса в SAP: возможные теги "касса", "вексель"
• Документ/Страница: Проект FileNet
  • Документ относится к IT проектам: возможные теги - "проект", "IT"
  • Документ относится к проекту FileNet: возможный тег - "FileNet"