[docs] ADT-QuickStart

[Michael Shigorin]

On Thu, Feb 10, 2005 at 12:28:12PM +0300, Kirill Maslinsky wrote:
> > PPS: ещё предлагаю устроить некий abstract в оном policy, дабы
> > бюрократизьм параграфов не оказывал своего сокрушительно
> > снотворного действия сразу.  Если не будет клеиться -- могу
> > попробовать набросать, но тогда Ктоне Спрятался -- Яне Виноват :)
> Очень будет хорошо, если набросаете и сюда запостите.

Attached.

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/
----------- следущая часть -----------
Кратко о проекте ALT Linux Docs Team для авторов и редакторов
=============================================================

Проект предназначен для взаимодействия желающих улучшить
документацию ALT Linux; подробная информация о нём доступна в
документе ALTLinuxDocsTeamPolicy, здесь же -- введение.

Если вы обнаружили неточность или неполноту освещения какого-либо
из аспектов ALT Linux в поставляемой документации, эту проблему
можно решить и лучше всего это может сделать наиболее
заинтересованный.

Исправлениями занимаются Редакторы, а созданием -- Авторы.

Для того, чтобы стать Редактором, необходимо зарегистрироваться
на https://bugzilla.altlinux.org и поместить исправление или
информацию для внесения такового в проект Docs.

Для того, чтобы стать Автором -- сформулировать, что именно
отсутствует в документации, создать (возможно, скомпоновать)
недостающий текст в удобной форме и известить о своём желании
помочь joindocs at altlinux.ru.

В письме следует указать тему документа, своё полное имя и
псевдоним (login), действительный адрес e-mail и публичную часть
2048-битного ключа OpenSSH DSA.

Решение о предоставлении доступа и вся необходимая дальнейшая
информация будут отправлены на адрес, указанный в письме Автора,
после чего можно приступать к оформлению и размещению пакета.

Оформление предлагается производить на манер (по идее, уже у вас)

ftp://ftp.altlinux.ru/pub/docs/adt_policy.tar.gz

-- архив имя_документа.tar.gz, содержащий каталог имя_документа/,
в котором размещён ``паспорт'' (информация о тексте, файл
docinfo), данные о правовом статусе текста (файл License) и,
возможно, история изменений (Changelog), а также каталог doc/,
который и содержит собственно предлагаемый документ.

Для примера docinfo загляните в adt_policy/examples/ -- проще
всего скопировать к себе и исправить по надобности.

Размещение при сконфигурированном ssh производится так:

rsync -Pav имя_пакета.tar.gz incoming:/incoming/docs/

Если что-то непонятно или не получается, пишите на joindocs@!