Документация

Автор: yr Дата: 24.08.2003 06:01
Мне кажется что команда АСП должна более активно заниматься переводом и обновлением документации.
Например в 9-ке очень много устаревших HOWTO. И например русский ман на rpm советует собирать пакеты командой rpm -bb *.src.rpm.
В итоге получаем кучу вопросов на форуме.

Особенно мало документации по аппаратному обеспечению. Понятно что она (док) быстро устаревает, но раз уж Вы взялись за выпуск дистрибутива то и документация должна быть на уровне.
Недостаточно документации на yum, а это главное средство обновления и уж точно заслуживает своего HOWTO с подробными примерами работы. Написали же РЕДХАТовци кучу инфы на рпм.

Короче болше новых доков длинных и подробных.. на русском:-)
Re: Документация 24.08.2003 08:53isn yr писал(а):


> Короче болше новых доков длинных и подробных.. на русском:-)

Поддерживаю это предложение.

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

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

Предлагаю в первую очередь снабдить подробной документацией ваши фирменные разработки.
Потому как найти по ним доку, кроме как у вас, негде.
Re: Документация 24.08.2003 13:06Vladimir Dyakov > Короче болше новых доков длинных и подробных.. на русском:-)

А также _обязательно_ на английском
Re: Документация 26.08.2003 11:35alardus Спасибо за предложение.
Я думаю, скоро появится примерно следующая возможность:

Дописывать в список HCL оборудование, которое вам удалось заставить работать (и которое отсутствует в списке). Разумеется, с пояснениями как вы этого добились.

Как именно это будет сделано - пока сказать затрудняюсь.
Re: Документация 26.08.2003 15:08Raptor 100% согласен.
Re: Документация 31.08.2003 09:0620khz > Дописывать в список HCL оборудование, которое вам удалось заставить работать (и которое отсутствует в списке). Разумеется, с пояснениями как вы этого добились.

Насколько понимаю, девиз таков: зачем делать то, что уже сделано.

Так зачем же описывать как, что сделать, вместо того, чтобы написать скриптики (и т.п.), которые сами при установке всё делали.
RSS-материал