Это старая версия документа.
Содержание
Как оформить вопрос для 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 в соответствующем подразделе
- снабдите текст вопроса ссылкой на материал (статью или конкретный параграф), который ответит на вопрос
.