Форум русскоязычного сообщества Ubuntu


Получить помощь и пообщаться с другими пользователями Ubuntu можно
на irc канале #ubuntu-ru в сети Freenode
и в Jabber конференции ubuntu@conference.jabber.ru

Автор Тема: Новые правила ресурса Документации  (Прочитано 24450 раз)

0 Пользователей и 1 Гость просматривают эту тему.

Оффлайн Zloy1

  • Активист
  • *
  • Сообщений: 261
    • Просмотр профиля
Re: Новые правила ресурса Документации
« Ответ #60 : 13 Июля 2012, 13:35:50 »
Ещё важный вопрос: давайте определим характер нашего раздела Документации. Наподобие Чем не является википедия - чем не является раздел Документации? Какие категории статей допустимы к публикации на ресурсе, какие - не нужны. Исходя из help.ubuntu.ru - становится более-менее понятно, что это раздел Помощи. Следовательно, и материалы там должны быть соответствующие?
У меня как-то лично не вяжутся материалы full_circle в Документации, но они там есть. Поправьте.  :)

Поддерживаю forekko. Надо начать с дефиниции того, что есть наша wiki и чем она не является. Но. Все уже знают, что любая wiki это не социальная сеть, бесплатный хоситнг, ... Поэтому, то чем не является википедия (по ссылке) нам бесполезно.

Что может быть в нашей вики, а чего в ней быть не должно
  • Перевод официального руководства? Нет
  • Запись а ла блог пост типа "Как я мучался с установкой на Asus EEE Pc ..."? Нет
  • Описание хака "Как ping по cron-у помогает держать интернет соединение"? Да, но определенно в отдельном разделе.
  • Статья о том, о чем уже написана прекрасная исчерпывающая статья на другом ресурсе? Нет
    Но если ее автор позволит взять ее за образец и улучшить, то несомненно - Да.
  • Оригинальная посредственная статья просто чтобы закрыть тему (как на википедии) ? Нет
  • Оригинальная статья чтобы закрыть тему, но только с краткими пояснениями к ссылкам на превосходный внешний материал? Да. Ведь зачем писать о том, о чем уже кем-то хорошо написано? Даром тратить силы. Тема Bash и в целом shell скриптинга - хороший пример.

Я не знаю, как определить что должно быть в вики - вероятно то, что не есть руководство, но
- лучшее что приходит в голову - то, что помогает пользователям понять, о чем говорит руководство пользователя или описывающее решение задачи или проблемы или помогающее перейти к действительно высококачественному внешнему контенту. По сравнению с руководством иначе структурированное, написанное понятно, а не академично, ориентированное на понятийную область, нежели на имплементацию. Например, если выбрать тему настройки сети, то я бы хотел видеть общую картину: компоненты сети, как они взаимодействуют, какова роль пользователя, перечень всех конфигов, которые влияют на сеть, список доступных пакетов в качестве тех или иных компонентов, со сылками на внутренние и внешние материалы, помогающие решить задачу или проблему. А не описание того, как работать с Network Manager.


Правила
имхо, эти правила http://ru.wikipedia.org/wiki/%D0%92%D0%B8%D0%BA%D0%B8%D0%BF%D0%B5%D0%B4%D0%B8%D1%8F:%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0_%D0%B8_%D1%83%D0%BA%D0%B0%D0%B7%D0%B0%D0%BD%D0%B8%D1%8F - только элемент разруливания конфликтов в большой бюрократической машине, коей является википедия.

Авторам же нашей вики - небольшому коллективу с большой текучкой  :) нужен нужен краткий свод абсолютно необходимых и однозначно понимаемых применимых к каждой статье простых сентенций. Одно из правил - "Не использовать неймспейсы". И все прочие должны быть в таком же стиле.

Классификация статей.
Наряду с тегами нужен механизм, который бы форсил автора задуматься и документировать к какому ограниченному домену относится статья. Актуальна ли она только для GNOME или KDE или для любой DE, зависит ли от версии ОС, справедливо ли для любого WM или только для определенного. Потому что если не форсить, то ясности не будет, а это очень мешает быстро разобраться, поможет тебе тот или иной материал или нет.

Например, можно для каждого автора в профайле сделать обязательными для заполнения поля теги, которые можно переносить в статью с возможностью редактирования. Это будет давать читателю информацию о том, в какой среде работал автор когда писал свою статью. Например такие теги поля:
версия ОС: 10.04 TLS Server
DE: LXDE
WM: Openbox
KDE: установлены приложения (варианты значений - Установлен полностью, Полностью отстуствует)
GNOME: установлены приложения
Управление сетью: Wicd 1.70
Менеджер файлов: PcManFM
Браузер: Firefox
и т.д. по всем значимым особенностям конфигурации данной конкретной инсталляции.

Можно завести пометки к статье типа:
Verified by user Malamut for
версия ОС: 12.04 TLS Desktop
DE: GNOME

...

Оффлайн demkov

  • Автор темы
  • Старожил
  • *
  • Сообщений: 2692
  • Юрист
    • Просмотр профиля
    • Контекстная реклама в MMGP
Re: Новые правила ресурса Документации
« Ответ #61 : 13 Июля 2012, 18:12:10 »
Цитировать
Авторам же нашей вики - небольшому коллективу с большой текучкой  :) нужен нужен краткий свод абсолютно необходимых и однозначно понимаемых применимых к каждой статье простых сентенций. Одно из правил - "Не использовать неймспейсы". И все прочие должны быть в таком же стиле.
Идею свести правила к минимуму поддерживаю, аки на форуме - меньше правил - меньше споров.
Для вебмастеров: CPC-реклама на MMGP-проектах!

Оффлайн Пользователь

  • Модератор форума
  • Старожил
  • *
  • Сообщений: 2700
  • Runtu XFCE 18.04 (64-bit)
    • Просмотр профиля
Re: Новые правила ресурса Документации
« Ответ #62 : 18 Июля 2012, 20:43:08 »
Вот эту страницу https://help.ubuntu.ru/terms/главная

Хотелось бы видеть такой (смотреть со слов "Добро пожаловать!") http://www.lubuntu.ru/wiki

То есть пара предложений и ниже ссылки.


Оффлайн Gannebal

  • Любитель
  • *
  • Сообщений: 87
    • Просмотр профиля
Re: Новые правила ресурса Документации
« Ответ #63 : 27 Сентября 2012, 19:50:04 »
пожалуй и я внесу свои 5 копеек. Предлагаю такое:
добавить автоматическую таблицу(которая будет вставляться по нажатию на кнопу в конструкторе статьи). В эту таблицу будет записываться пользователями, например, версия ОС на которой пошел костыль к драйверу и в таблице будут только версии ОС. Ну и прописать в правилах добавление такой таблички для соответствующих статей. Примерно такая же система у Wine
Не Рим, а Карфагенский сенат победил Ганнибала

Оффлайн demkov

  • Автор темы
  • Старожил
  • *
  • Сообщений: 2692
  • Юрист
    • Просмотр профиля
    • Контекстная реклама в MMGP
Re: Новые правила ресурса Документации
« Ответ #64 : 20 Марта 2013, 00:29:01 »
Тема полгода пустует, ап.
Друзья, никому не интересно принять участие в написании правил help.ubuntu.ru?
Действующие правила по факту не действуют. Мы должны сделать новые!
Действующие (устарело): https://help.ubuntu.ru/%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0
Действующие инструкции (тоже): https://help.ubuntu.ru/terms/
Где, возможно, будут: https://help.ubuntu.ru/%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0/
Для вебмастеров: CPC-реклама на MMGP-проектах!

Оффлайн Malamut

  • Ubuntu Member
  • Администратор
  • Старожил
  • *
  • Сообщений: 3337
  • Я добрый, честно!
    • Просмотр профиля
    • Моя страница на Launchpad
Re: Новые правила ресурса Документации
« Ответ #65 : 20 Марта 2013, 21:24:22 »
forekko,
Только одна просьба: не выкидывайте совсем теги из правил :coolsmiley: Всё же полезная штука. Но не как основа структурирования, ка это предполагалось моими правилами, безусловно.
"Носителем суверенитета и единственным источником власти в Российской Федерации является ее многонациональный народ" Конституция РФ

Оффлайн demkov

  • Автор темы
  • Старожил
  • *
  • Сообщений: 2692
  • Юрист
    • Просмотр профиля
    • Контекстная реклама в MMGP
Re: Новые правила ресурса Документации
« Ответ #66 : 20 Марта 2013, 21:27:13 »
Malamut,
думаю, у вики не будет единой основы структурирования.
Во всяком случае, вполне дуалистична: правильно внутренние ссылки + теги и индексы для любознательных.
Для вебмастеров: CPC-реклама на MMGP-проектах!

 

Страница сгенерирована за 0.049 секунд. Запросов: 22.