[docs] документация, инфраструктура, фирмы, сообщество

[Michael Shigorin]

PreScriptum: ключевой абзац -- последний.

On Thu, May 12, 2005 at 10:14:32PM +0400, Kirill Maslinsky wrote:
> Замучался я отвечать, уже третий раз ответ переписываю, чтобы 
> хоть сколько-то его сделать понятным и конструктивным.

Аналогично... (хотя это письмо как-то обошлось, спасибо
за понимание и юмор :-)

> Если туманно, прежде чем ругаться, задайте вопросы. 
> Возможно, удастся достигнуть полезных практических результатов.

Стараюсь.  Собственно, в меру сил последними занимаюсь на втором
фронте (вслед за lav@ и mithraen@).

Кстати, есть вот такое -- на сейчас лучший newsletter:
http://www.freesource.info/wiki/ALTLinux/ZamechanijaPoObnovleniju

И там даже есть feed:
http://www.freesource.info/wiki/AltLinux/ZamechanijaPoObnovleniju/revisions.xml

> > Ну и сейчас вот думаю -- получится ли отвлечь Кирилла на то,
> > чтобы посмотреть, чего там на этих самых wiki.sisyphus.ru и
> 1.  Документации по-любому у нас есть и будет два массива:
> вылизанная и невылизанная.  Вылизанная идёт на бумагу и в
> дистрибутивы, она нужна offline.

Да.

> Невылизанная самозарождается в _разных_ местах, в т. ч. на wiki.

Да.

> Поэтому нет смысла структурировать wiki, ибо наличие жёсткой
> структуры -- свойство вылизанной документации, невылизанной, я
> бы сказал, жёсткая структура противопоказана.

Нет, и об этом хорошо сказал Саша.

> Показаны средства индексирования (ключевые слова) и поиска.

Всегда.

> 2.  Из экономии ресурсов необходимо, чтобы вылизанная
> документация была подмножеством невылизанной. 

Ммм... если к невылизанной относить и драфты тех, кто вылизывает
-- то да, иначе необязательно.

> Проблема в том, что содержимое wiki жёстко привязано к
> конкретному сайту, online. Вынуть документ наружу или засунуть
> внутрь wiki без интерактивного вмешательства человека и
> открытого броузера -- можно ли? 

Вынуть -- вполне, там даже (ouch!) вордовый экспорт есть.
Плюс к тому -- IMHO это более разумная цена, чем в случае heap.

> Если возможности экспорта нет, значит, вылизывать документаци
> _в wiki_ нет смысла.

Не вылизывать, а структурировать блоками.

Кирилл, ещё раз -- предлагаю похоронить идею экспорта/импорта как
не имеющую существующих доказательств реальности.  Конверторы
никто не написал и что-то мне подсказывает -- и не напишет.

> А жаль, поскольку это оставило бы все преимущества wiki по
> оперативному обновлению и дополнению документа. Экспорт в виде
> cut-n-paste кусочков не больше страницы -- не годится. 

Это и не должен быть cut'n'paste.  Лично я не намереваюсь тратить
на художественное оформление материалов в wiki больше времени,
чем получается по ходу дела (и то ограничивая свои привычки).

Там важней актуальность.  На бумагу оттуда надо 10% слов и из них
-- большинство других.  Rewrite по мотивам.

> <JT>
> После предложения такого способа работы приходится заподозрить,
> что Миша состоит в профсоюзе компьютеров и борется против их
> угнетения человеком. Нет автоматизации! Вздумали тоже
> перекладывать работу на компы, пусть человек потрудится.

Да нет, просто человек лепит какие-то планы на автоматизацию,
потом не набирается смелости посмотреть всем этим туманным
"напишутся конверторы" в глаза и при этом держится за планы,
которые бессмысленны без _реализации_ этой автоматики.

В итоге больше усилий тратится неоптимальным образом.

> И за 8-ми часовой рабочий день он выступал, я подозреваю, для
> того, чтобы компы не перегревались.  А то они пашут почти
> круглосуточно, как пролетарии XIX века. ;)
> </JT>

Зачот (TM)

Вообще-то мне приходится управлять людьми и рассчитывать нагрузку
так, чтобы они не выгорали, а задачи при этом -- решались.

Вот из этого бедного, но какого-никакого опыта и вылилось письмо
в начале треда.

Впрочем, Саша грустный немного юмор тоже оценил.

> 3. Как сделать экспорт.
> Я попробовал wget wiki.sisyphus.ru/somewikipage

http://wiki.sisyphus.ru/HomePage/print ?

> Чтобы полученный html был годен в качестве модуля вылизанной
> документации, нужно получить от wiki еще список авторов
> страницы (и редакторов, по возможности). 

http://wiki.sisyphus.ru/HomePage/revisions ?

> Вот и всё, и экспорт готов. Реально сделать?
> Если да, то часть вылизанной документации можно разрабатывать
> на wiki, включая сюда написание, редактирование и обновление
> текстов.

Мммм... ну можно попробовать и так, но IMCO старая схема
достаточно неплохо отработана и технически, и (главное!)
организационно.

Проблема не в экспорте-импорте, а в ответственности за
содержание.

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : http://lists.altlinux.ru/pipermail/docs/attachments/20050513/22ad013d/attachment.bin