[docs] proposal

Ср Ноя 20 20:42:48 MSK 2002

Andriy Dobrovol's'kii пишет:
> Получается длинно, но не нашел что отрезать.

То же самое:-)

> Vadim Vinichenko wrote:
> 
>> Andriy Dobrovol's'kii пишет:
>>
>>> Andriy Dobrovol's'kii wrote:
>>>
>>> > Hi,
>>> >
>>> >> AD> У меня к Вам предложение как к автору "Предварительных сведений о
>>> >> AD> Линуксе".
>>> >> AD> Мне кажется было бы лучше свести содержание "Файловая система",
>>> >> AD> "Разделы, необходимые для работы" и "Имена дисков и разделов" 
>>> в одну
>>> >> AD> главу с "Диски и разделы" из описания собственно установки, а
>>> >> AD> "Командные оболочки" и "МС" перенести за описание установки. 
>>> Такое
>>> >> AD> расположение текстов мне кажется более логичным. И легче читать
>>> >> когда
>>> >> AD> все вместе, и лучше когда пояснения рядом с местом, когда они 
>>> нужны.
>>> >>
>>> > AEN> Давайте обсудим в docs.
>>> > AEN>
>>> > AEN> Rgrds, Алексей
>>> >
>>> >>
>>> >>
>>> > Обсудим?
>>
>>
>>
>> По моему разумению, этого делать не следует. Мне как раз 
>> представляется весьма разумной идея "Предварительных сведений" - 
>> компактно собрать минимум базовых сведений о системе, а также 
>> практических рекомендаций, необходимых начинающему пользователю для 
>> того, чтобы не "застрять" в системе. По task-oriented главам, включая 
>> руководство по установке (в узком смысле), я бы этого расtaskивать не 
>> стал. Например, назначение каталогов верхнего уровня - фундаментальный 
>> факт, значимость которого выходит далеко за пределы отдельного этапа 
>> установки, и который не может быть без "натяжки" приписан никакой 
>> отдельной задаче. Хотя на него можно сослаться из Installation Guide. 
>> А рассуждения о том, сколько места на какой раздел отводить - вот они 
>> как раз в этом Guide по праву.
>>
> 
> Я ж не против предварительных сведений. Я хочу только найти им наилучшее 
> место. :)

Фрагментировать их не хотелось бы... По крайней мере, мне.

>> Более того, я бы считал, что предварительные сведения нужно "укрепить 
>> и расширить", добавив к ним:
>>
>> * информацию о файлах настройки в Linux (я как-то бросал сюда план, но 
>> развернуть его руки пока не доходят);
>> * концепцию прав, а также пользователей и групп (Здесь, среди прочего, 
>> хорошо бы упомянуть, что в ALTLinux штатным средством придания 
>> пользователю прав для ряда конкретных задач является добавление его к 
>> соответствующей группе. Например, сборка RPM.)
>> * не сказать ли пару слов о том, что бывает текстовая консоль, а 
>> бывает X, в котором есть xterm вместо текстовой консоли? (не уверен, 
>> стОит ли об этом писать, но если уж написано про mc...) Затем отослать 
>> к разделам про KDE, GNOME, IceWM и т.д.
>>
> 
> Все это нужно, но ИМХО, в "Руководстве пользователя", а не в 
> "Руководстве по установке"

Можно по-разному. В настоящий момент "Руководство по установке" помимо 
собственно описания оной содержит ряд сведений предварительного 
характера - поддержка, документация, да, наконец, GPL. Это единственный 
том, который можно, хотя бы условно, считать "началом" документации. 
Полагаю, что "Предварительные сведения о Linux" из этого ряда не выбиваются.

В то же время, "Руководство пользователя" сейчас содержит только 
документацию к конкретным программам. Но, в принципе, можно поместить и 
в начало этого руководства.

> Краткой информации о Linux сейчас море. Мне трудно представить ситуацию 
> в которой
> Linux купит и будет ставить человек ничего о нем до того не слышавший 
> вообще.
> Хотя бывает конечно всякое.

Ну,
(а) я думаю, что многие вещи, содержащиеся в документации, доступны в 
других публикациях;
(б) если Вам известно _компактное_ и (относительно) _связное_ описание 
основных понятий системы для начинающего пользователя, доступное под 
свободной лицензией - поделитесь, пожалуйста, ссылкой. Возможно, этот 
документ следует использовать для документации ALTLinux ("основные 
понятия", разумеется, с точки зрения пользователя, ибо с другой точки 
зрения основными понятиями могут быть open-close-read-write-fork-exec);
(в) вообще же мой опыт, возможно, односторонний, показывает, что с 
компактными и связными введениями для начинающих, как правило, туговато 
в самых разных предметных областях.

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

>> Помещать ли "Предварительные сведения" до установки или после - все 
>> равно. Можно рассуждать в том направлении, что сначала ставят, а потом 
>> используют, а можно - что, приступая к установке, полезно хотя бы 
>> смутно представлять, что ставишь.
>>
> 
> 
> Лучше уж четко представлять, что ставишь. :) А логика простая, если 
> человек не удосужился до сих пор прочесть об основах, то и сейчас читать 
> не станет. Кроме того, в процессе установки, для новичка все сведения по 
> оболочке бесполезны, а профи их и так знает. А все, что касается дисков, 
> будет крайне необходимо на этапе разметки при установке. И гораздо 
> удобнее не листать в это время все руководства туда-сюда, а увидеть все 
> в кратком изложении рядом. Тогда и расширять ничего не нужно. 

Но эти сведения нужны не только при установке. Как быть с этим? М.б., 
продублировать?

> фундаментальные пояснения о файловой системе, конечно нужны. Лучше всего 
> если это будет перевод стандарта на файловую систему Linux, ИМХО. И уже 
> в "Руководстве пользователя". 

Боюсь, с "фундаментальными" сведениями я неточно выразился. Я имел в 
виду не "основательные, глубокие", а, скорее, "базовые", необходимые при 
(практически) любой работе с системой. Но я никоим образом не утверждаю, 
что перевод/изложение стандарта включать не нужно. Но - не в 
предварительные сведения.

 > И краткие сведения о системе и её
 > использовании понадобятся новичку именно после установки, при первом
 > включении. Потому и предлагаю перенести их в конец брошюры.

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

Но, на самом деле, хотя я оставил бы "Предварительные сведения" там, где 
они есть сейчас, эта позиция не является принципиальной. Гораздо более 
важным мне представляется наличие где бы то ни было специального раздела 
"Предварительных сведений", не растянутого на отдельные куски даже ради 
"ориентации на задачи" (но в разделах, ориентированных на задачи, что-то 
можно продублировать). И наличие в самом начале документации (хорошо бы 
вообще roadmap к ней иметь) внятного указания на наличие такого раздела.

-- 
С уважением,
Вадим