Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
правила_faq [2009/03/22 17:49] |
— (текущий) | ||
|---|---|---|---|
| Строка 1: | Строка 1: | ||
| - | ====== Как оформить вопрос для FAQ ====== | ||
| - | |||
| - | Просто дамп мыслей по текущему положению вещей | ||
| - | |||
| - | Чтобы организовать нормальные списки просмотра по версиям дистрибутива, см. пример с общими вопросами выше для: | ||
| - | * Ubuntu 8.10 (Intrepid Ibex) | ||
| - | * Ubuntu 8.04 LTS (Hardy Heron) | ||
| - | * Всех, перечисленных выше версий Ubuntu, т.е. полный список | ||
| - | |||
| - | Нужны тэги, список тэгов: | ||
| - | ^ Тэг ^ Комментарий ^ | ||
| - | | faq | обязательный для всех статей FAQ | | ||
| - | | 8.10 \\ 8.04 \\ ... | если вопрос/ответ относится к одной или нескольким версиям Ubuntu | | ||
| - | | все_версии | если вопрос/ответ относится ко всем версиям Ubuntu | | ||
| - | | общие | вопрос/ответ, связанные с около Ubuntu бла-бла-бла, как то вопросы нумерации и названия версий, идеологические вопросы типа отсутствия рут-а и т.п. | | ||
| - | |||
| - | Минимальный шаблон страницы: | ||
| - | <code>===== Это вопрос? ===== | ||
| - | |||
| - | тут идёт ответ на это вопрос | ||
| - | |||
| - | {{tag>faq}} | ||
| - | |||
| - | </code> | ||
| - | |||
| - | При оформлении статей, относящихся к нескольким версиям Убунту... Если рецепт одинаков - просто проставляем тэги версий. Если для разных версий решение проблемы отличается (примером может быть русификация консоли), то создаём одну статью с вопросам/ответами, разделив решения для разных версий соответствующим форматированием и проставив тэги этих версий. | ||
| - | |||
| - | <code>===== Это вопрос? ===== | ||
| - | |||
| - | ==== Ubuntu 8.10 ==== | ||
| - | тут идёт ответ на вопрос | ||
| - | |||
| - | ==== Ubuntu 8.04 ==== | ||
| - | тут идёт ответ на вопрос | ||
| - | |||
| - | {{tag>faq 8.04 8.10}} | ||
| - | |||
| - | </code> | ||
| - | |||
| - | ===== FAQ: лог из одной конференции одного брейн-дампа... ===== | ||
| - | <code> | ||
| - | [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: У какой брэйн-дамп о_О | ||
| - | </code> | ||
| - | |||
| - | ====== FAQ: Дополнения к общим правилам ====== | ||
| - | |||
| - | Ознакомьтесь с [[правила|общими правилами Ubuntu Wiki]]. | ||
| - | |||
| - | **Внимание!** В данном разделе не нужно размещать статьи! | ||
| - | |||
| - | Вместо этого: | ||
| - | * определите, на какой вопрос нужно ответить пользователю | ||
| - | * проверьте, нет ли похожего вопроса в FAQ, возможно надо просто исправить формулировку вопроса, чтобы она более точно охватывала проблему | ||
| - | * чётко, с позиции пользователя, сформулируйте этот вопрос в одной из двух форм ("Что такое..." или "Каким образом...") | ||
| - | * если сформулировать просто не удается, посмотрите, нельзя ли разделить проблему на составляющие | ||
| - | * посмотрите, какой раздел [[doc:главная|Документации]] или [[howto:главная|HOWTO]] освещает проблему лучше всего | ||
| - | * если статьи или параграфа, отвечающего на вопрос нет, создайте статью в соответствующем разделе | ||
| - | * разместите сформулированный ранее вопрос в индексе FAQ в соответствующем подразделе | ||
| - | * снабдите текст вопроса ссылкой на материал (статью или конкретный параграф), который ответит на вопрос | ||
| - | |||
| - | . | ||
| - | ---- | ||
| - | [[faq:главная|← Назад в индекс FAQ]] | ||
