правила_faq

Это старая версия документа.


Как оформить вопрос для FAQ

Просто дамп мыслей по текущему положению вещей

Чтобы организовать нормальные списки просмотра по версиям дистрибутива, см. пример с общими вопросами выше для:

  • Ubuntu 8.10 (Intrepid Ibex)
  • Ubuntu 8.04 LTS (Hardy Heron)
  • Всех, перечисленных выше версий Ubuntu, т.е. полный список

Нужны тэги, список тэгов:

Тэг Комментарий
faq обязательный для всех статей FAQ
8.10
8.04
если вопрос/ответ относится к одной или нескольким версиям Ubuntu
все_версии если вопрос/ответ относится ко всем версиям Ubuntu
общие вопрос/ответ, связанные с около Ubuntu бла-бла-бла, как то вопросы нумерации и названия версий, идеологические вопросы типа отсутствия рут-а и т.п.

Минимальный шаблон страницы:

===== Это вопрос? ===== 

тут идёт ответ на это вопрос

{{tag>faq}}

При оформлении статей, относящихся к нескольким версиям Убунту… Если рецепт одинаков - просто проставляем тэги версий. Если для разных версий решение проблемы отличается (примером может быть русификация консоли), то создаём одну статью с вопросам/ответами, разделив решения для разных версий соответствующим форматированием и проставив тэги этих версий.

===== Это вопрос? ===== 

==== Ubuntu 8.10 ====
тут идёт ответ на вопрос

==== Ubuntu 8.04 ====
тут идёт ответ на вопрос

{{tag>faq 8.04 8.10}}

FAQ: лог из одной конференции одного брейн-дампа...

[01:46:02 PM] kwah: А вообще, я думал о том, что оно должно быть самодостаточным...
[01:46:34 PM] kwah: Т.е. смотрите, каждый Вопрос-Ответ они как бы уже предполагают наличие некоторых навыков
[01:47:16 PM] Garfeild: мням
[01:47:43 PM] kwah: Думаю, что в каждой такой мини-статье должна быть секция, типо, что нужно знать перед тем, как применять... Тупо набор линков на доки или другие ЧаВО/Хауту.
[01:48:17 PM] kwah: Например... Нужно выполнить какие-то команды в терминале - линк на что такое терминал, где его взять
[01:48:33 PM] offoffoff: ау
[01:48:48 PM] kwah: нужно редактировать с правами суперпользователя - линк, как это делать...
[01:48:59 PM] alsvartr (alsvartr@jabber.org) has left
[01:49:06 PM] offoffoff: kwah: можно просто ссылку со слова "терминал"
[01:49:09 PM] offoffoff: "суперпользователь"
[01:49:25 PM] kwah: Не эт не то.
[01:49:41 PM] kwah: Просто нужны азы по любому.
[01:50:08 PM] offoffoff: это в Азбуку
[01:50:11 PM] kwah: На каждом таком ЧаВО ты просто обрисовываешь, что нужно знать...
[01:50:14 PM] offoffoff: засылки сделать
[01:50:52 PM] kwah: Чтобы каждый, ткнувшись в статью из faq мог сразу оценить, знает он всё, что нужно или нет
[01:51:42 PM] kwah: И ещё, и это касается всех редакторов!
[01:51:56 PM] kwah: Часто не нужно писать конкретики
[01:52:13 PM] kwah: Скажем вхождения типа:
[01:52:23 PM] kwah: sudo apt-get install бла-бла-бла
[01:52:51 PM] kwah: Просто заменяются фразами: Установите пакет(ы) бла-бла-бла
[01:53:25 PM] kwah: Если в начале статьи любовно собраны ссылки на 
[01:53:36 PM] kwah: Как устанавливать программное обеспечение
[01:54:01 PM] kwah: то ответ на вопрос становиться намного меньше 
[01:54:07 PM] kwah: это раз
[01:54:22 PM] Agafonov: kwah: да правильно, со слова "Установите пакет(ы)" - ссылка статью
[01:54:38 PM] kwah: если кто-то пришёл и не знает, как ус танавливать софт - ему придётся этому учиться
[01:54:40 PM] kwah: это два
[01:56:12 PM] kwah: И всё-таки, хотелось бы иметь вначале или в конце каждого подобного вопроса-ответа секцию типа, что нужно знать со ссылками...
[01:56:44 PM] kwah: Ибо ссылки из ответа будут уводить в сторону, я думаю... 
[01:56:59 PM] kwah: В общем, надо об этом ещё подумать-с...
[01:57:14 PM] kwah: Основных статей-то всего ничего получается
[01:57:43 PM] kwah: Ибо почти все чаво крутятся вокруг установить, отредактировать и всё это ещё и с супер-пользователем.
[01:58:48 PM] kwah: У какой брэйн-дамп о_О 

FAQ: Дополнения к общим правилам

Ознакомьтесь с общими правилами Ubuntu Wiki.

Внимание! В данном разделе не нужно размещать статьи!

Вместо этого:

  • определите, на какой вопрос нужно ответить пользователю
  • проверьте, нет ли похожего вопроса в FAQ, возможно надо просто исправить формулировку вопроса, чтобы она более точно охватывала проблему
  • чётко, с позиции пользователя, сформулируйте этот вопрос в одной из двух форм («Что такое…» или «Каким образом…»)
  • если сформулировать просто не удается, посмотрите, нельзя ли разделить проблему на составляющие
  • посмотрите, какой раздел Документации или HOWTO освещает проблему лучше всего
  • если статьи или параграфа, отвечающего на вопрос нет, создайте статью в соответствующем разделе
  • разместите сформулированный ранее вопрос в индексе FAQ в соответствующем подразделе
  • снабдите текст вопроса ссылкой на материал (статью или конкретный параграф), который ответит на вопрос

.


← Назад в индекс FAQ