[devel] git/gear/git.alt docs

[Dmitry V. Levin]

On Wed, May 23, 2007 at 02:52:50PM +0400, Valery V. Inozemtsev wrote:
> В сообщении от 23 мая 2007 Dmitry V. Levin написал(a):
> > On Wed, May 23, 2007 at 02:12:26PM +0400, Valery V. Inozemtsev wrote:
> > > В сообщении от 23 мая 2007 Dmitry V. Levin написал(a):
> >
> > [...]
> >
> > > > Документации по каким инструментам не хватает?
> > >
> > > документации вообще. GEAR-QUICKSTART явно не достаточно
> >
> > Документации вообще не бывает.
> >
> > + git: к нему много документации разного уровня, как в пакетах
> > git-core/git-doc, так и в сети.
> 
> ну это пропустим

Это было бы ошибкой.  Для того, чтобы эффективно применять такой инструмент
как git, недостаточно один раз просмотреть
/usr/share/doc/git-1.5.1.6/everyday.html

> > + gear: к нему есть исчерпывающие man pages и QUICKSTART:
> > $ rpmquery -ld gear
> > /usr/share/doc/gear-1.2.5/QUICKSTART.ru_RU.KOI8-R
> > /usr/share/man/man1/gear-commit.1.gz
> > /usr/share/man/man1/gear-hsh-build.1.gz
> > /usr/share/man/man1/gear-srpmimport.1.gz
> > /usr/share/man/man1/gear-update-tag.1.gz
> > /usr/share/man/man1/gear-update.1.gz
> > /usr/share/man/man1/gear.1.gz
> > /usr/share/man/man5/gear-rules.5.gz
> 
> это надо почитать

Конечно.

> > + git.alt: к нему есть документация на wiki.
> 
> это не документация, это обрывки тайных знаний, которые надо еще найти

Основная информация изложена по адресу
http://www.freesource.info/wiki/AltLinux/Sisyphus/devel/git
Там нет никаких тайных знаний, в предположении что пользователь владеет
git'ом в необходимом объёме.

> > Документации по каким инструментам не хватает?
> 
> систематизированных и собранных воедино тайных знаний, которые сейчас еще надо 
> найти на wiki/врасылке, т.е. такого подробного User Manual. рано или позно 
> это все равно придется сделать хотя бы для тех кто только вступает в team и 
> вообще об этом ничего не слышал

Для того, чтобы написать такой manual, надо пройти путь вступающего в team
и всё задокументировать.  Добровольцы есть?


-- 
ldv
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : http://lists.altlinux.org/pipermail/devel/attachments/20070524/18d4ea75/attachment.bin