В качестве wiki-движка используется программа MoinMoin. Эта страница содержит заметки о том, как публиковать документацию в wiki. Наша цель состоит в том, чтобы создать доступную, надёжную и централизованную документацию.

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

Для создания нового руководства надо выполнить два простых шага:

1. Поиск. Перед добавлением руководства в wiki, воспользуйтесь поиском по статьям с похожей темой. Если найденные документы недостаточно заполнены или устарели, обновите их ! Будет лучше, если множество статей со схожей темой вы объедините в одно подробное руководство.

2. Создание страницы. Если руководств по заданной теме не найдено, создайте новую страницу.

   • Подумайте над названием - выбор точного имени очень важен для того, чтобы пользователь легко и быстро нашёл ваше руководство.
     1. Выберете наглядное имя, описывающее суть содержимого
     2. Избегайте слова "howto" в заголовке страницы (здесь всё howto !)

     3. Выберете имя с заглавными буквами (типа WikiName). Не используйте пробелы или подчеркивания в именах.

   • Просто введите название новой страницы в адресную строку вашего броузера и выберете DocumentationTemplate. Примечание: вы должны залогиниться в систему, чтобы это работало.

Стиль

Указания по стилю, используемом в документации

• Основные принципы

  • Релизы Ubuntu - старайтесь всегда указывать для какой версии Ubuntu написано руководство. Когда указываете версию Ubuntu, используйте запись вида "Ubuntu X.XX (Прозвище)" или просто "Ubuntu X.XX". Например, "Ubuntu 5.10 (Breezy Badger)" или "Ubuntu 5.10", вместо "Breezy" или "Ubuntu Breezy".

  • Репозитории - capitalize the names of the Universe & Multiverse repositories when you use them. Also, Linux, Ubuntu, Windows, etc should be capitalized.

  • Установка ПО - при описании установки ПО, пытайтесь не указывать менеджер пакетов (например, apt-get). Вместо этого просто используйте фразу "Установите пакет X из репозитория Y". Если надо, сделайте ссылку на страницу, документирующую отличный менеджер пакетов, InstallingSoftware.

  • Источник ПО - в основном советуется программное обеспечение из главного источника (Main repository), перед эквивалентным ПО из других источников (Universe repositories), как гарантировано обновляемое и безопасное.

  • Объединяйте, не дублируйте! - обыщите wiki в полной мере перед добавлением материала. Если уже есть страница с подробным описанием темы, не добавляйте новую. Лучше объедините материал с существующей страницей. При этом, на существующей странице новые сведенья пишите в подходящем для них месте.

• Styleguide - the Documentation Team has published some specific guidelines for documentation, the Documentation Team Styleguide.

Форматирование

Помощь в оформлении страниц

Основы

• Каждый абзац должен отделяться от других пустой линией.
• Для создания списков, поставьте пробел в начало строки и звёздочку (* - для точек в списке), номер (для нумерованного списка) или букву и т.д.

• Для создания заголовков, используйте запись вида = Заголовок = для заголовка первого уровня, == Заголовок == для заголовка 2 уровня и так далее...

• Заключите слово или фразу в двойные кавычки '' для отображения наклонным шрифтом, в тройные кавычки - жирным.

• Для оформления цитаты заключите абзац в  {{{  }}}.

Например, страница может выглядеть так:

= Заголовок страницы =
== Подзаголовок ==
Этот текст показывает как писать в wiki. The following things are important:
 * Прочитайте рекомендации по стилю оформления
 * Убедитесь, что вы не повторяете уже существующий материал в wiki
 * ask the Documentation Team to check the guide afterwards and place it in CategoryCleanup

Следующий абзац - буквенный список:
 a. это ''первый'' пункт
 a. это ''второй'' пункт
 a. это ''третий'' пункт
{{{
это блок кода
} }} (пробела не должно быть в вашей версии)

За подробной информацией обращайтесь в HelpContents

Advanced Features

As you edit the wiki you will learn how to use the power of the wiki software to do even more clever things! Here are some examples:

• To see almost all the wiki's formatting in action, have a look at the SyntaxReference page.

• Inserting Icons - see IconsPage

• Inserting a table of contents such as what you see at the top of this page:

  • ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Содержание'''[[BR]][[TableOfContents]]||

• To insert a simple table of contents, without the box around it, just use: [[TableOfContents]])

Удаление и переименование

Удаление и переименование страниц в этой wiki запрещено, но если вам необходимо это сделать - сообщите в WikiTeam.

Коммуникация

Guidelines for ensuring that your work is communicated to others working on the wiki.