Справка:Описания клиентов: различия между версиями

Материал из Мир Jabber
Перейти к навигацииПерейти к поиску
м
м
Строка 17: Строка 17:
* Не стоит в названии каждой ссылки повторять название клиента, но страница, на которую идет ссылка, должна содержать имя клиента, т.е. ссылка формируется примерно так: <nowiki>[[Смена пароля в Клиент|Смена пароля]]</nowiki>. Т.е., попадая на данную страницу ты гарантированно видишь, к какому клиенту она относится.
* Не стоит в названии каждой ссылки повторять название клиента, но страница, на которую идет ссылка, должна содержать имя клиента, т.е. ссылка формируется примерно так: <nowiki>[[Смена пароля в Клиент|Смена пароля]]</nowiki>. Т.е., попадая на данную страницу ты гарантированно видишь, к какому клиенту она относится.
* Для статей используйте следующие категории:
* Для статей используйте следующие категории:
** '''Клиент''' для страницы-описания клиента
** Список категорий согласно поддерживаемым ОС для страницы-описания клиента
** '''Регистрация''' для страницы регистрациия в клиенте
** '''Регистрация''' для страницы регистрациия в клиенте
** '''Пользовательские действия''' для страниц "Добавление контакта", "Вход в конференцию", "Обновление vCard", "Смена пароля", "Подключение транспортов"
** '''Пользовательские действия''' для страниц "Добавление контакта", "Вход в конференцию", "Обновление vCard", "Смена пароля", "Подключение транспортов"
** '''Вход в конференцию''' для страницы "Вход в конференцию"
** '''Настройка передачи файлов''' для страницы "Настройка передачи файлов"
** '''Подключение транспортов''' для страницы "Подключение транспортов"
* Ссылки на статьи с пользовательскими действиями размещать в описании соответствующих статей, т.е., "[[Пароль]]", "[[VCard]]" и т.д.
* Ссылки на статьи с пользовательскими действиями размещать в описании соответствующих статей, т.е., "[[Пароль]]", "[[VCard]]" и т.д.
* Скриншоты желательно размещать по центру либо в preview-виде. Удобным вариантом размещения скриншотов является галерея, размещенная по центру страницы. Другим вариантом является размещение превью скриншотов и текста рядом сними (так уж повелось, что обычно скриншот находится слева) - в виде пошагового руководства, при этом текст, описывающий скриншот, заканчивается шаблоном <nowiki>{{-}}</nowiki>. Не стоит загромождать один раздел скриншотами, возможно, стоит разнести описание по разным разделам.
* Скриншоты желательно размещать по центру либо в preview-виде. Удобным вариантом размещения скриншотов является галерея, размещенная по центру страницы. Другим вариантом является размещение превью скриншотов и текста рядом сними (так уж повелось, что обычно скриншот находится слева) - в виде пошагового руководства, при этом текст, описывающий скриншот, заканчивается шаблоном <nowiki>{{-}}</nowiki>. Не стоит загромождать один раздел скриншотами, возможно, стоит разнести описание по разным разделам.
* "Регистрация" подразумевает краткое вступление, скачивание, установку/запуск, описание процедуры создания нового аккаунта, выход в сеть, если этого требует клиент - заполнение [[VCard]].
* "Регистрация" подразумевает краткое вступление, скачивание, установку/запуск, описание процедуры создания нового аккаунта, выход в сеть, если этого требует клиент - заполнение [[VCard]].
* В конце статьи по регистрации аккаунта необходимо добавить раздел "Ссылки" со ссылками на описания добавления пользователя: вход в конференцию и регистрацию транспортов.
* В конце статьи по регистрации аккаунта необходимо добавить раздел "Ссылки" со ссылками на описания добавления пользователя, вход в конференцию и регистрацию транспортов (если клиент поддерживает данные функции).
* "Вход в конференцию" описывается с учетом двух вариантов входа - через меню подключения к конференции и через работу с транспортами, если эти варианты поддерживаются клиентом.
* "Вход в конференцию" описывается с учетом двух вариантов входа - через меню подключения к конференции и через работу с транспортами, если эти варианты поддерживаются клиентом.
* Списки ссылок выделять маркером (как, например, весь этот список, т.е. "*")
* Списки ссылок выделять маркером (как, например, весь этот список, т.е. "*")

Версия 22:06, 8 мая 2009

Если Вы хотите сделать описание для Jabber-клиента, который отсутствует на странице-списке клиентов, то Вам пригодятся следующие указания:

  • Ссылка на клиент должна быть со страницы клиентов (если иное не оговорено на странице обсуждения клиентов, например, для Windows-клиентов уже просто нет места)
  • Ссылка должна являться корректным именем клиента
  • Описание состоит из нескольких предложений, описывающих особенности данного клиента. Обычно неплохо Jabber-клиенты описываются на Wikipedia, поэтому на вступление можно ориентироваться там. Для уменьшения необходимости постоянного обслуживания страниц можно не описывать фичи клиентов, так как они постоянно меняются и хорошо описаны, к примеру, на Wikipedia. Справа делается скриншот. Внизу делается раздел "Ссылки" со следующими ссылками:
    • Регистрация
    • Добавление контакта
    • Вход в конференцию
    • Обновление vCard
    • Смена пароля
    • Подключение транспортов
    • Настройка передачи файлов
    • ---любые дополнительные статьи--
    • Ссылка на официальный сайт
    • Ссылка на описание на Wikipedia
    • Описание на JRD-Wiki
  • Не стоит в названии каждой ссылки повторять название клиента, но страница, на которую идет ссылка, должна содержать имя клиента, т.е. ссылка формируется примерно так: [[Смена пароля в Клиент|Смена пароля]]. Т.е., попадая на данную страницу ты гарантированно видишь, к какому клиенту она относится.
  • Для статей используйте следующие категории:
    • Список категорий согласно поддерживаемым ОС для страницы-описания клиента
    • Регистрация для страницы регистрациия в клиенте
    • Пользовательские действия для страниц "Добавление контакта", "Вход в конференцию", "Обновление vCard", "Смена пароля", "Подключение транспортов"
    • Вход в конференцию для страницы "Вход в конференцию"
    • Настройка передачи файлов для страницы "Настройка передачи файлов"
    • Подключение транспортов для страницы "Подключение транспортов"
  • Ссылки на статьи с пользовательскими действиями размещать в описании соответствующих статей, т.е., "Пароль", "VCard" и т.д.
  • Скриншоты желательно размещать по центру либо в preview-виде. Удобным вариантом размещения скриншотов является галерея, размещенная по центру страницы. Другим вариантом является размещение превью скриншотов и текста рядом сними (так уж повелось, что обычно скриншот находится слева) - в виде пошагового руководства, при этом текст, описывающий скриншот, заканчивается шаблоном {{-}}. Не стоит загромождать один раздел скриншотами, возможно, стоит разнести описание по разным разделам.
  • "Регистрация" подразумевает краткое вступление, скачивание, установку/запуск, описание процедуры создания нового аккаунта, выход в сеть, если этого требует клиент - заполнение VCard.
  • В конце статьи по регистрации аккаунта необходимо добавить раздел "Ссылки" со ссылками на описания добавления пользователя, вход в конференцию и регистрацию транспортов (если клиент поддерживает данные функции).
  • "Вход в конференцию" описывается с учетом двух вариантов входа - через меню подключения к конференции и через работу с транспортами, если эти варианты поддерживаются клиентом.
  • Списки ссылок выделять маркером (как, например, весь этот список, т.е. "*")

Структуру статей рекомендуется изучать на примере уже готовых статей, например, описания Jabber-клиента Psi.