[docs] записки дебианщика

Kirill Maslinsky kirill на altlinux.ru
Чт Янв 11 11:10:20 MSK 2007


On Wed, Jan 10, 2007 at 08:09:41PM +0300, Денис Смирнов wrote:
> On Wed, Jan 03, 2007 at 04:39:18AM +0200, Michael Shigorin wrote:
> 
> MS> http://mambaram.livejournal.com/54775.html
> 
> Если не считать того что автор слишком жестко выражается -- он прав:
> 1. документация в виде манов на тот же etcnet была бы крайне полезна;

Согласен, что по манам есть лакуны, которые нужно заполнить. 
Кроме etcnet, что еще приходит в голову? Давайте попробуем 
составить список -- пусть он будет одной из задач по документации
к предстоящему выпуску.

> 2. отсутствие краткого описания alt-specific делает переход на него с
> другого дистрибутива без альтовца под рукой малореальным. С точки зрения
> затрат времени, естественно.

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

Т. е. в идеале написать документы
README.ALT-specific.Debian
README.ALT-specific.Fedora
README.ALT-specific.Ubuntu ...

А общие части потом вынести в общий README.ALT-specific 
Проблема только в числе таких документов, и выборе аудиторий.

Опять же, если мы составим список из нескольких наиболее 
важных дистрибутивов, по отношению к которым нужно описать
специфику, то это также можно поставить как задачу по 
документации к выпуску.

> А тот факт что эти затраты окупаются сразу-то не виден.

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


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