[docs] [RH] Better Linux release notes through design thinking

Kirill Maslinsky kirill на altlinux.ru
Ср Май 24 11:45:56 MSD 2006


> > http://www.redhat.com/magazine/019may06/features/documentation_design/
> 
> Великолепно!

К бочке положительных эмоций могу добавить ложку анализа.

У них там заметно узкое место: принципиально не решена проблема
конвертации. Т. е. они маринуют текст на вики до самого 
последнего момента, потом конвертируют чем-то в DocBook, после чего 
текст ``подвергается чистке'' и именно из докбука идёт на перевод
и на печать. А это значит, что есть ``точка подрыва'', где требуется
много срочного ручного занудного (т. е. не волонтёрского) труда.
И нет технологии результаты этого труда вернуть назад на вики. 
Переводы так и остаются замороженными. Конечно, в случае 
release notes вопрос возвращения не особо актуален...

Как всегда, остаётся неясным вопрос с границами применимости
их метода. Видно, что оно у них получилось и заработало, однако
обратите внимание -- на одном и довольно специфическом виде 
документов -- release notes. Они уже заявляют, что будут теперь
так делать всю документацию -- распространённый соблазн: заработало
где-то -- втащить всюду. Но на других текстах с другими требованиями 
могут проявиться неисправимые преимущества данного метода. 
В общем, будем следить. 

-- 
Kirill Maslinsky
ALT Linux Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: not available
Url : http://lists.altlinux.org/pipermail/docs/attachments/20060524/b39b29ae/attachment.bin 


Подробная информация о списке рассылки docs