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

[Alex Ott]

>Alex Ott пишет:
>
>> P.S. На мой взгляд - не стоит сосредотачиваться на написании 
>> руководства по линуксу - лучше описать процедуру установки, 
>> а также ALT-вскую специфику, остальные книги по линуксу пользователь 
> > найдет/прочитает если заинтересуется, благо их есть и много.
>
>Здесь я с тобой не соглашусь.
>
>Я не просто так спросил про миссию проекта ниже. Если просто описывать 
>специфику ALT -- да это очень удобно, потому что не требует больших 
>человеческих и временных ресурсов.

я говорил про те книги, которые идут с дистрибутивом. Писать можно про все, но не все это нужно пихать в дистрибутив.

>Но. В реальности никакой консолидированной работы по написанию 
>документации, если не считать проект Сорекса, нету. По большому счёту, 
>как только дело доходит до написания документации, вся суть командной 
>работы в опенсорсе вдруг проваливается куда-то в бездну, да так глубоко, 
>что звука падения её тушки не слышно вовсе.
>
>Когда человек пишет доку по интересному её софту, он пишет в первую 
>очередь о самом софте, и только потом -- о специфике окружения. То есть 
>в нормальной доке всегда есть определённый уровень абстракции от 
>окружения (разумеется, не ко всем докам это применимо, однако же).
>
>Простой пример. Я сейчас пишу "Building and installing JAMin". Сначала я 
>описываю сборку и установку базового для JAMin софта из исходников, и 
>только потом о том, как установить весь этот софт в Debian, Gentoo, FC3, 
>ALT, SuSE и т.д. Почему? Потому что я заведомо полагаю свою доку 
>полезной для всего множества пользователей, а не только для подмножества 
>ALT или Gentoo.
>
>Ты когда-нибудь просил авторов сторонней (относительно ALT) документации 
>написать что-нибудь для ALT? Стандартный ответ: "Нуууу.... Я использую 
>RedHat.... Так что даже не знааааюююю....".

А чем оно должно отличаться? это не автор документации должен писать, а ALT обнаружив изменения, может их засабмитить автору документации

>Сама суть написания доки к опенсорсному продукту состоит в том, чтобы 
>донести её до максимально возможного количества людей, вне зависимости 
>от их пола, национальности, вероиспо^^^^используемого дистрибутива. Ты 
>ведь и сам пишешь доки по Emacs, не завязываясь на дистрибутивы ;)

я даже на ОС не завязываюсь :-)

>Итак, возвращаясь к миссии. Мне лично было бы приятно, если бы миссией 
>ALD стало создание и поддержка свободной платформы для документирования 
>опенсорсного софта.

ну есть же проекты которые уже это делают? или я не прав?