Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
wiki:новые_правила [2012/05/16 14:43] [Шаблон статьи про программу] |
wiki:новые_правила [2014/07/13 04:59] (текущий) удалил подпись |
||
|---|---|---|---|
| Строка 2: | Строка 2: | ||
| <note important>Это черновик! Если есть идеи - смело правьте эту страницу, но добавляйте информацию только с подписью (есть в инструментах)</note> | <note important>Это черновик! Если есть идеи - смело правьте эту страницу, но добавляйте информацию только с подписью (есть в инструментах)</note> | ||
| - | **Документация Ubuntu.ru** снискивает всё большую популярность как внутри круга почитателей Ubuntu, так и далеко за его пределами. В связи с этим, способствуя дальнейшему перспективному развитию ресурса, члены Сообщества принимают и обязуются соблюдать нижеследующие **Правила и рекомендации**: | + | **Документация Ubuntu.ru** становится всё более популярной как внутри круга почитателей Ubuntu, так и далеко за его пределами. В связи с этим, способствуя дальнейшему перспективному развитию ресурса, члены Сообщества принимают и обязуются соблюдать нижеследующие **Правила и рекомендации**: |
| ===== Создание статьи ===== | ===== Создание статьи ===== | ||
| Строка 17: | Строка 17: | ||
| >> --- [[user>Пупизоид]] //2012/05/15 13:18// | >> --- [[user>Пупизоид]] //2012/05/15 13:18// | ||
| Публиковать рекомендуется только статьи, представляющие интерес широкого круга членов Сообщества. Не стоит писать и опубликовывать материал, интересный лишь его автору; степень значимости статьи можно примерно определить количеством ссылок на неё с других статей. Чем больше таких ссылок - тем важнее статья, тем большую она несёт в себе информационную ценность.\\ | Публиковать рекомендуется только статьи, представляющие интерес широкого круга членов Сообщества. Не стоит писать и опубликовывать материал, интересный лишь его автору; степень значимости статьи можно примерно определить количеством ссылок на неё с других статей. Чем больше таких ссылок - тем важнее статья, тем большую она несёт в себе информационную ценность.\\ | ||
| - | Объём статей должен превышать 10-15 строк полезного текста. Статьи, не преодолевшие порог, будут поставлены в [[http://help.ubuntu.ru/?do=showtag&tag=deleteme|очередь на удаление]]. | + | Объём статей должен превышать <del>10-15</del> примерно 20 строк полезного текста. Статьи, не преодолевшие порог, будут поставлены в [[http://help.ubuntu.ru/?do=showtag&tag=deleteme|очередь на удаление]] или перенесены в содержание другой статьи. |
| > 10-15 строк- мало, мне кажется | > 10-15 строк- мало, мне кажется | ||
| > --- [[user>Пупизоид]] //2012/05/16 13:43// | > --- [[user>Пупизоид]] //2012/05/16 13:43// | ||
| Строка 29: | Строка 29: | ||
| >> Ну в картинках то ковардак будет, их там нужно систематизировать, потому что структура папок то видна. | >> Ну в картинках то ковардак будет, их там нужно систематизировать, потому что структура папок то видна. | ||
| >> --- [[user>Пупизоид]] //2012/05/15 13:04// | >> --- [[user>Пупизоид]] //2012/05/15 13:04// | ||
| + | |||
| + | > В названии статей не должно быть никаких слов, обозначающих действие. Как-то: установка, настройка и т.д. В качестве общего исключения могут выступать статьи, образованные в результате разделения одной очень большой статьи на части путём выделения самых больших разделов. | ||
| + | > --- [[user>Malamut]] //2012/05/22 14:10// | ||
| Создавая новую страницу, внимательно отнеситесь не только к её наполнению, но и наименованию с заголовком - визитной карточке страницы Документации. Имя статьи - слово или словосочетание, отображаемое после имени раздела 'wiki/', например, 'wiki/**правила**', где **правила** - имя статьи в системе Документации. [[#Создание статьи|Имя статьи задаётся её автором]]. Заголовком статьи считается первый [[syntax#Разбивка на разделы|заголовок 1-го уровня]], отображающийся в шапке материала и, кроме того, на других индексных страницах. \\ | Создавая новую страницу, внимательно отнеситесь не только к её наполнению, но и наименованию с заголовком - визитной карточке страницы Документации. Имя статьи - слово или словосочетание, отображаемое после имени раздела 'wiki/', например, 'wiki/**правила**', где **правила** - имя статьи в системе Документации. [[#Создание статьи|Имя статьи задаётся её автором]]. Заголовком статьи считается первый [[syntax#Разбивка на разделы|заголовок 1-го уровня]], отображающийся в шапке материала и, кроме того, на других индексных страницах. \\ | ||
| Строка 39: | Строка 42: | ||
| <file> | <file> | ||
| ======Имя статьи====== | ======Имя статьи====== | ||
| - | В этом разделе приводится общая информация о последующем тексте, так сказать, художественная часть, приводятся ссылки в вики на использующиеся термины. | + | Тут необходимо изложить основную информацию о рассматриваемом ниже предмете и (или) вопросе. Первые абзацы статьи играют роль вступительной части, приводятся ссылки в вики на используемые термины. |
| - | ======//Произвольно//====== | + | =====//Произвольно//===== |
| - | в силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | + | В силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. |
| ======Ссылки====== | ======Ссылки====== | ||
| здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме. | здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме. | ||
| Строка 51: | Строка 54: | ||
| * //Произвольно// - в силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | * //Произвольно// - в силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | ||
| * **См.также** - здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме.</del> | * **См.также** - здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме.</del> | ||
| + | |||
| + | |||
| ===== Наполнение и содержание ===== | ===== Наполнение и содержание ===== | ||
| Следует учитывать следующее: короткий, но максимально полный; содержательный, но без лишнего материал увеличивает шансы прочтения пользователем статьи до конца, и, возможно, решения своей проблемы. \\ | Следует учитывать следующее: короткий, но максимально полный; содержательный, но без лишнего материал увеличивает шансы прочтения пользователем статьи до конца, и, возможно, решения своей проблемы. \\ | ||
| Строка 56: | Строка 61: | ||
| Любой другой материал, уже изложенный в другой статье, заново пересказывать не стоит - лучше просто дать ссылку.\\ | Любой другой материал, уже изложенный в другой статье, заново пересказывать не стоит - лучше просто дать ссылку.\\ | ||
| Если вы обнаружили в себе рвение и возможность описать что-то не совсем подходящее к редактируемой статье - подумайте, [[#Минимальный объём и значимость|нужно ли это остальным]]? - и, если нужно - напишите отдельную, с подробным раскрытием вопроса. | Если вы обнаружили в себе рвение и возможность описать что-то не совсем подходящее к редактируемой статье - подумайте, [[#Минимальный объём и значимость|нужно ли это остальным]]? - и, если нужно - напишите отдельную, с подробным раскрытием вопроса. | ||
| + | <note important>Ни в коем случае не забывайте про [[wiki:syntax#ссылки]]! Чем больше в статье [[wiki:syntax#ссылки|ссылок]], приоритетно - на [[wiki:syntax#внутренние|внутренние ресурсы]], тем прочнее она входит в систему Документации, тем крепче и стабильнее наблюдается взаимосвязь между разнообразными материалами.</note> | ||
| Все статьи следует, по возможности, **[[#Иллюстрации и снимки экрана|сопровождать наглядными иллюстрациями]]**. | Все статьи следует, по возможности, **[[#Иллюстрации и снимки экрана|сопровождать наглядными иллюстрациями]]**. | ||
| <note important>Формирование [[#Структура статьи|верной структуры]], [[#Оформление|оформления]], использование возможностей [[wiki:syntax|синтаксиса]] и, конечно же, достойное [[#Наполнение и содержание|содержание]] и соблюдение общепринятой [[terms/стилистика_статей|стилистики статей]] определяют успех статьи.</note> | <note important>Формирование [[#Структура статьи|верной структуры]], [[#Оформление|оформления]], использование возможностей [[wiki:syntax|синтаксиса]] и, конечно же, достойное [[#Наполнение и содержание|содержание]] и соблюдение общепринятой [[terms/стилистика_статей|стилистики статей]] определяют успех статьи.</note> | ||
| + | > Всегда стоит помнить, что многие пользователи используют не самую последнюю версию Ubuntu. Особенно это замечание актуально для серверных версий. Поэтому если вы хотите обновить статью, заменив какие-то устаревшие части на актуальные для текущего релиза Ubuntu, то **всегда** оставляйте комментарии с информацией о том, как нужно поступать при использовании старых версий. Проще говоря: **никогда** не удаляйте полезную информацию из статьи, если она актуальна хоть для какой-нибудь версии Ubuntu. Вместо этого переносите её в отдельные разделы или заметки, с пометкой об области применимости. | ||
| + | > --- [[user>Malamut]] //2012/05/24 10:43// | ||
| ===== Иллюстрации и снимки экрана ===== | ===== Иллюстрации и снимки экрана ===== | ||
| Все статьи следует сопровождать пояснительными снимками экрана либо иллюстрирующими изображениями((к иллюстрирующим изображениям можно отнести, к примеру, логотип программы с официального сайта)). \\ | Все статьи следует сопровождать пояснительными снимками экрана либо иллюстрирующими изображениями((к иллюстрирующим изображениям можно отнести, к примеру, логотип программы с официального сайта)). \\ | ||
| + | Элементы оформления статей (галочки, крестики, логотипы Ubuntu и т.д.) необходимо брать (и добавлять свои) в пространстве **wiki:оформление:**. | ||
| >Основные требования: все скриншоты должны быть сделаны при использовании стандартной темы рабочего стола Unity со стандартным набором иконок с одним из стандартных фонов, дабы не отвлекать читателя на изучение особенностей оформления. Он должен видеть то, что будет видеть на экране своего монитора. | >Основные требования: все скриншоты должны быть сделаны при использовании стандартной темы рабочего стола Unity со стандартным набором иконок с одним из стандартных фонов, дабы не отвлекать читателя на изучение особенностей оформления. Он должен видеть то, что будет видеть на экране своего монитора. | ||
| > | > | ||
| Строка 80: | Строка 89: | ||
| > | > | ||
| > --- [[user>Пупизоид]] //2012/05/16 13:52// | > --- [[user>Пупизоид]] //2012/05/16 13:52// | ||
| + | >> [[http://lurkmore.to/Tl;dr|тлдр]], нет правда. Подсократить бы, раза в три. Притом, плагин же менять будут?:-? Я надеюсь. --- [[user>forekko]] | ||
| Необходимо напомнить, что изображения, найденные в сети Интернет, сохранять на сервере ресурса Документации не обязательно, их можно поместить и отображать в статье напрямую с другого сайта. При таком использовании подразумевается указание ссылки на сайт. | Необходимо напомнить, что изображения, найденные в сети Интернет, сохранять на сервере ресурса Документации не обязательно, их можно поместить и отображать в статье напрямую с другого сайта. При таком использовании подразумевается указание ссылки на сайт. | ||
| + | DELETEME --- [[user>forekko]] | ||
| + | |||
| + | > Логотипы программ - в /wiki, скриншоты и все остальные иллюстрации - в wiki/program_name. | ||
| + | > --- [[user>Malamut]] //2012/05/18 01:33// | ||
| =====Статьи про программы===== | =====Статьи про программы===== | ||
| Имя страницы статьи про программу, сервис и т.д. должна соответствовать шаблону: | Имя страницы статьи про программу, сервис и т.д. должна соответствовать шаблону: | ||
| Строка 132: | Строка 146: | ||
| > --- [[user>Malamut]] //2012/05/12 13:49// | > --- [[user>Malamut]] //2012/05/12 13:49// | ||
| =====Статьи в разделе "Совместимость"===== | =====Статьи в разделе "Совместимость"===== | ||
| + | > Этот раздел вообще не трогаю; мне кажется, его стоит вынести в отдельные рекомендации конкретно раздела. --- [[user>forekko]] | ||
| В данном разделе создаются статьи для каждого устройства, в которых описываются особенности (или отсутствие) их использования вместе с Ubuntu. При написании статьи, воздержитесь, пожалуйста, от эмоциональной окраски текста, используйте технический язык.\\ Имя адреса страницы должно содержать производителя и модель описываемого устройства: | В данном разделе создаются статьи для каждого устройства, в которых описываются особенности (или отсутствие) их использования вместе с Ubuntu. При написании статьи, воздержитесь, пожалуйста, от эмоциональной окраски текста, используйте технический язык.\\ Имя адреса страницы должно содержать производителя и модель описываемого устройства: | ||
| <file>help.ubuntu.ru/совместимость/hp_pavilion_dv6_2055er</file> | <file>help.ubuntu.ru/совместимость/hp_pavilion_dv6_2055er</file> | ||
| Строка 161: | Строка 176: | ||
| Примечания: | Примечания: | ||
| 1) для "нет проблем\решаемые проблемы\нерешаемые проблемы" можно придумать картинки веселые, и в шаблоне привести все три, нужно будет удалить лишнее только. | 1) для "нет проблем\решаемые проблемы\нерешаемые проблемы" можно придумать картинки веселые, и в шаблоне привести все три, нужно будет удалить лишнее только. | ||
| + | |||
| + | |||
| + | ====== Неструктурированные наброски идей по мотивам правил википедии ====== | ||
| + | |||
| + | Статьи следует писать на литературном русском языке в [[wpru>Научный_стиль|научном стиле]] от третьего лица. | ||
| + | |||
| + | Если на предмет статьи существует несколько различных взглядов, то в идеале их все необходимо изложить, или хотя бы добавить пометки про другие варианты. | ||
| + | |||
| + | Соблюдайте удобную для читателя последовательность повествования и размещения служебных пометок в исходном тексте статьи. | ||
| + | |||
| + | Последовательность изложения: | ||
| + | |||
| + | В статьях следует повествовать: | ||
| + | от общего к частному | ||
| + | от простого к сложному | ||
| + | в порядке важности, известности, достоверности | ||
| + | |||