[docs] Re: ВНИМАНИЕ: отчёт и насущные проблемы

[Vitaly Ostanin]

Alexandre Prokoudine пишет:
> Kirill Maslinsky пишет:
> 
>>При этом есть некоторые привходящие обстоятельства:
>>
>>* В docbook.dtd около 400 элементов. Изучение docbook -- большое сложное дело.
>>* Авторов, пишущих в docbook, фактически нет среди авторов текстов нашей 
>>  документации. Есть авторы, которые готовы писать и обновлять тексты, их
>>  тексты нужны, но они обычно не готовы писать и поддерживать их в docbook. 
>>* "Корпоративный" docbook подразумевает ряд требований, которые не входят в 
>>  docbook, сформировались в моей голове из практики, и, к сожалению,
>>  пока нигде не описаны.

Эти требования со временем вливаются в DocBook DTD. Даже такие 
капризные, как теги для javascript popups - тоже вливаются.

>>* Нигде не оговорено, какую именно работу по доведению документа от
>>  исходного текста до пригодного "в модули" документации ALT согласны 
>>  брать на себя участники проекта. Фактически, нет распределения 
>>  ответственности.
>>* Время на выпуск релиза очень невелико сравнительно с объёмом работ.
>>
>>Поэтому получается, что:
>>
>>- Перед выпуском появляется какое-то количество "сырых текстов";
>>- Перед выпуском резко (или постепенно) устаревает часть существующих текстов;
>>- Непонятно, кто за какие тексты отвечает, авторы свои тексты доводить 
>>  до конечного состояния не будут. Согласование в рассылке, кто что и 
>>  когда будет делать потребует весьма много времени (рабочего времени
>>  выпускающего, в частности). И даже если дождаться такой правки, 
>>  при этом ещё останется огромная ручная работа, которую всё равно 
>>  делает один человек. Он не успеет её сделать, если получит 
>>  правку в последний день.
> 
> 
> Кирилл, извини, но я не вижу никакой прямой связи между количеством 
> тегов в Db/XML и наличием сырых текстов. На моей памяти не меньше пяти 
> человек просили простым русским языком дать им вводную документацию по 
> докбуку. Её так никто и не написал. Потенциальные авторы на это 
> посмотрели и быстро увяли. Это раз.
> 
> Два. "Сырые тексты" прямо перед релизом обычно не появляются. Обычно они 
> обнаруживаются в таком состоянии. Объяснение чему всем прекрасно 
> известно: time, time, time... Если же ты имеешь в виду в срочном порядке 
> написанные к релизу доки, то их включения в релиз, имхо, стоит избегать. 
> Впрочем, это зависит от компетенции автора и его владения родным языком.
> 
> Три. Насколько я заметил (поправь меня если я ошибаюсь), вряд ли можно 
> назвать дистрибутив ALT Linux, вышедший согласно расписанию. Это всегда 
> добавляет проблем при планировании расхода время и распределении 
> приоритетов. В условиях неопределённости мотивация контрибьюторов имеет 
> весьма нездоровую, но легкопредсказуемую тенденцию сам знаешь к чему.
> 
> Четыре.
> Четыре-один: Есть поддерживаемые тексты.
> Четыре-два: Есть тексты, авторы которых до сих пор неизвестны.
> Четыре-три: Есть авторы, которые про необходимость обновления док ничего 
> не знали (например, Виталий Останин + Psi). 

Автор знает, что он раззвиздяй, он просто не знает, в какой 
момент это будет особенно заметно :-\

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

Справедливости ради - не было оговорено, всё ограничилось моим 
предложением. "Предлагал взятку, но не дал". Отмашки не было. Я и 
сейчас готов попробовать, только скажите слово наконец, 
официальные лица.

Не в тему ещё раз повторю для ленивых: в DocBook _ДВА_ тега. 
PARA, который абзац, и SECTION, который раздел. Если этого много, 
остаётся plain text.

И опять повторю. IMHO, нет в этом письме насущных проблем - всё 
то же отсутствие удобного редактора. Даже pdf вывод уже решается 
3-мя вариантами, а вот редактора нет. И не надо форматы 
изобретать на зависть комитету DocBook - всё те же проблемы с 
редакторами будут, которые не vi/emacs.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt at vzljot.ru
JID:     vyt at vzljot.ru
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 256 bytes
Desc: OpenPGP digital signature
Url : http://lists.altlinux.ru/pipermail/docs/attachments/20050112/98e8ce7e/signature-0001.bin