[Desktop] схема документации на desktop4.0
Artem Zolochevskiy
=?iso-8859-1?q?artem=2Ezolochevskiy_=CE=C1_gmail=2Ecom?=
Вт Июл 3 11:11:28 MSD 2007
hi all
Вот какой в целом мне видится документация на Desktop4.0
Desktop 4.0
-----------
Итак.
Господин X держит в руках DVD с Desktop 4.0
Какие вопросы будут его интересовать.
Вероятно, прежде всего -- как это установить?
Ну а после установки, видимо, -- и что дальше с этим делать?
Значит главная задача прилагаемой документации сводится именно к ответам на
эти два вопроса.
1. как установить
2. и что дальше?
установить
----------
* Разъяснения того, а что же господин X держит в руках. Хоть можно и
предположить, что раз уж он это держит, то примерно знает, что это такое. Но
всё же, уточним для снятия всякого рода недопониманий.
СТАТУС: реализовано.
МОДУЛИ ДОКУМЕНТАЦИИ:
-whatis_linux.kirill
-whatis_alt.kirill
-whatis_desktop4.0.azol
* Руководство должно охватить всё, то необходимое для того, чтоб человек
оказался перед
"рабочим столом". К сожалению, в описании процедуры установки не обойтись без
лирических отступлений. Особенно на тему "разбивка диска". Естественно
предупреждаем и о резервном копировании.
СТАТУС: реализовано (нужно просто следить за актуальностью модулей)
МОДУЛИ ДОКУМЕНТАЦИИ:
-backup_before_install.kirill
-hd_planning.kirill
-alterator_vm.kirill
-hd_naming.kirill
-hd_structure.kirill
-linux_filesystem.kirill
-linux_fstypes.kirill
-install0.kirill
-install2.kirill
-alterator_users.kirill
-alterator_apt.kirill
-alterator_network.kirill
-alterator_timezone.kirill
-alterator_x11.kirill
-install_finish.kirill
Здесь, в принципе всё. Господин X должен уже сидеть абсолютно счастливый за
свежеустановленным Desktop 4.0 :-)
То, что ниже, -- это уже начало ответа на вопрос "и что дальше?".
* Описание "Центра управления системы (web)" и "Центра управления системы"
как "официального" способа конфигурации. Указываем и на "ручной" способ.
Обязательно описание системы установки дополнительного ПО.
Обязательно включение модуля документации linux_basics.kiril, где речь о
включении/выключении компьютера, текстовом/графическом режимах и пр.
Обязательно включение модуля документации documentation_alt.kirill, где речь о
man/apropos/whatis/info//usr/share/doc//где в меню ссылки на ALT-документацию
СТАТУС: реализовано частично
МОДУЛИ ДОКУМЕНТАЦИИ:
-smc.azol
-/var/www/html/fbi/help/ru_RU/alterator.html
-manual_config.azol
-packages_apt.kirill
-packages_synaptic.azol
-linux_basics.kiril
-documentation_alt.kirill
В принципе этого должно быть достаточно для старта. Но так, как надеяться на
то, что пользователь после установки и прочтения documentation_alt.kirill
смело пойдёт решать свои постустановочные задачи чтением man/info итп не
приходится, то добавляем ещё и
* "быстрый старт" для часто возникающих задач.
СТАТУС: не реализовано
МОДУЛИ ДОКУМЕНТАЦИИ:
-quickstart.azol
Все вышеуказанное и должно составлять печатный DVD буклет. Т.е это -- та база
с которой можно начать осмысленно работать.
и что дальше?
-------------
Начальный толчок дан в linux_basics.kiril + documentation_alt.kirill
+ "быстрый старт" печатного буклета.
Остальной объём документации -- в эл. виде.
Ссылку на документацию -- на самом видном месте (раб столе/меню/упоминание в
печатном буклете)
Эл. документация -- два раздела (к примеру таблица в два столбца)
* эл. собрат печатного буклета
* прочая доступная в виде модулей документация, наличие, которой имеет смысл в
desktop.
Теперь мысли о "прочей" документации. Что у нас вообще есть?
Есть наработанный материал (гора модулей документации)
следует отсортировать этот список на предмет
1. принципиальной применимости к Desktop
Эта попытка сделана мной здесь:
http://lists.altlinux.org/pipermail/docs/2007-June/006433.html
2. целесообразности наличия конкретного модуля
тут можно различать варианты 4.0. К примеру есть модули отлично подходящие
для "образовательного" дистрибутива, но не думаю, что нужны для просто
DVD-версии -
3. решить вопрос о модулях, дублирующих содержание справочной информации. К
примеру dialup_short.kirill по сути пересказ KDE-документации на kppp.
4. выявить важные области использования desktop непокрытые имеющимися модулями
документации и создать эти модули.
Вот тут надо сильно думать. Что включать? Что дописывать? Где будет достаточно
отослать из "быстрого старта" на официальную документацию по тому или иному
ПО.
Ясно что в этой "дополнительной" части должны быть модули, отсутствующие в
печатном руководстве, но на которые в нём есть ссылки:
-Saga_of_Devices.george
-wine_intro.kirill
-linux_apps.kirill
Историческо-идеологический раздел, думаю, тоже нужен
-freesoft_history.kirill
-linux_history.kirill
-free_and_open_source.kirill
Далее думаю, смотрю.
Чуть позже опишу, что пойдет в дополнительный раздел документации.
Как всегда комментарии предложения приветствуются.
--
Артём Золочевский
Подробная информация о списке рассылки Desktop