[Junior] документация к junior -- оглавление

[Kirill Maslinsky]

On Wed, Dec 05, 2007 at 11:09:26AM +0200, Artem Zolochevskiy wrote:
> hi all
> 
> Как часть документации к junior у нас вырисовывается:
> * Руководство пользоватля
> * Руководство учителя/администратора
> 
> Просьба заинтересованных взглянуть на примерное оглавление, и сказать что 
> стоит добавить/убрать. Содержимое самих тектов, естественно, будет 
> адаптированно. Сейчас нужно определиться с "оглавлением".
> 
> ftp://ftp.altlinux.org/pub/people/azol/beta/junior_user/index.html
Не уверен, что стоит раздел по работе с командной строкой ставить 
в начале руководства. Как показывает практика, это слишком
непривычно, многие не понимают и пугаются.
Вообще не факт, что стоит здесь вводить противопоставление "командная
строка / графический интерфейс". Как-то может строить выпуск более 
с точки зрения задач пользователя? А уж какой там интерфейс, это уже
второй вопрос.

Непонятное название раздела "Руководства", а в этом разделе непонятые
названия глав (по именам программ). Нужно помнить, что аудитория у
Junior будет в основном такая, которой эти названия программ ничего
не говорят. Нужно в заголовки выносить функциональность (типа Редактор
векторной графики (Inkscape))

Запуск win-приложений, кажется, занимает слишком почетное место в
структуре руководства. 

> ftp://ftp.altlinux.org/pub/people/azol/beta/junior_admin/index.html
Может, первый раздел назвать "Первоначальная настройка?"
Желательно, чтобы в нем были описания конкретых модулей, типа управления
пользователями. (соответственно первоначальным задачам настройки) 

Настройка загрузки -- есть очень важная в контексте Junior тема --
двусистемная установка и соответственно загрузка. Может быть это как-то 
выпятить в оглавлении? 

Получается не очень внятное дублирование разделов между "Установка и
удаление программ" и "Программы" (который самый последний)

Оглавление раздела про настройку системных служб сейчас выглядит 
очень выглядит ориентированным а профессионального админстратора 
(термины очень умные, а для чего эти службы все нужны, и что вообще
такое системная служба неподготовленный человек может совсем не понимать). 
Опять же, аудитория у руководства администратора будет -- все те же
преподаватели, которым нужно что-то конкретное для класса настроить, 
и они в действительности совсем не являются настоящими системными 
администраторами, так что подход к строению руководства "Как в Мастере" 
здесь не очень уместен, наверное.

Общее впечатление от оглавления -- пока довольно рыхлое, к сожалению. 
Нужно попробовать представить себя на месте школьного учителя :)

-- 
Кирилл Маслинский
Альт Линукс
руководитель издательских проектов
http://heap.altlinux.ru