[docs] Проект оглавления Руководства по эксплуатации Compact 3.0
Kirill Maslinsky
kirill на altlinux.ru
Пт Апр 1 18:08:31 MSD 2005
Привет!
> >Ниже -- черновик оглавления руководства по эксплуатации к выходящему
> >вскоре Compact 3.0. Помимо этого руководства предполагается ещё
> >отдельное руководство по установке.
> >
> Почитав это письмо и обсуждение, прихожу к выводу, что снова "телегу
> впрягают впереди лошади". До составления оглавления, ИМХО, нужно
> четко определить комплектацию выпуска и его целевую аудиторию. От
> этого зависит о чём и как писать...
Целевая аудитория -- OEM-пользователи.
У выпускающих дистрибутив есть некоторое представление о комплектации, я
на него ориентировался при составлении оглавления; публичное обсуждение
задач выпуска бывало в devel@ и, наверное, ещё где-то.
> В бумажном руководстве обязательно нужно внятные описания по
> настройке железа. В смысле "куда бежать" в случае проблем с
> конкретными типами железок. В особенности это касается возможных
> проблем с видео. И не должно быть привязок к установленности Windows.
А куда бежать -- в поддержку? Тогда это раздел ``поддержка''.
Или в магазин за другим, подходящим оборудованием? ;)
> >Предлагаю для электронного руководства следующую структуру:
> >
> >Два больших раздела:
> > - Кратко и по существу
> > - Подробности
> >
> Очень трудно реализуемо. Я бы делил на "инструкции"(КакСде)
> и "теорию". Где теория -- всё, что не инструкция.
> И всю "теорию" в электронную форму.
Я именно это и имел в виду, просто назвал иначе.
Чистые инструкции, равно как и чистая теория, практически не встречаются
в жизни. Обычно они смешаны, с преобладанием того или другого.
--
Kirill Maslinsky
ALT Linux Documentation Team
-------------- next part --------------
z'╣ЛmjшZr··э╡г+╧╤чtж╕zz-jЖ╒∙╕Еy<╘y╙i√'╤*'Ч≤)╡('jш╚y(Ё{_=o+^╟7╛rz-jЖ╒∙╕ЕyJЕ├шiЪЫb╡ш√ыb·Лk╩Зb╔ЙФj)v┤,Щ╚miхfz{lЪm4ГN4вЖ╦▌]Соз╤ж°├g╖╣╦╖
Подробная информация о списке рассылки docs