[devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф)

[devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф)

[Michael Shigorin]

PreScriptum: перевожу вопрос по _документированию_ в devel@,
сохраняя контекст.  raorn@ ответил либо предложил иное, см.:
http://lists.altlinux.org/pipermail/devel-newbies/2010-January/000171.html

On Tue, Jan 26, 2010 at 11:01:30PM +0300, Anton A. Vinogradov wrote:
> Дано:
> 0. Имеем самосборный guake-0.4.0-alt0.2.src.rpm
> 1. Умеем собирать в ~/RPM
> 2. Умеем собирать в hasher
> 3. Имеем смутное представление что такое git
> 4. Понятия не имеем, что такое gear
> 5. Не имеем времени "сражаться с этим в воображении"
> 
> Надо:
> Как можно быстрее протолкнуть пакет в сизиф.
> 
> Начинаем:
> http://www.altlinux.org/Git.alt/Краткое_руководство

Сдобрил примечаниями, но вообще наше около-git.alt-овое хозяйство
напрашивается на повторный проход по документации с girar-utils.

Не соображу только, как лучше:

- рядом упоминать и gear-*/girar-*, и ssh git.alt init-db;
  + pro: понимание механизмов работы утилит
  + contra: потенциальная каша в головах
- упоминать только высокоуровневые утилиты, описывая их
  функциональность и отправляя в ман-страницы либо исходники
  за деталями (но там не всегда обозримо);
  + pro: более краткие и читабельные страницы
  + contra: отдаление от понимания происходящего
- переименовать текущую страницу в "техническое руководство",
  а в качестве "краткого руководства" описать утилиты.
  + pro: документированность высокого и низкого уровня
  + contra: ?

> "Создать свой репозиторий на git.alt очень просто"
> Создал. Зачем мне test? А как удалить?
> ладно. пусть будет.
> создадим то, что надо
> arc@arc-laptop ~ $ ssh git.alt init-db guake
> girar-init-db:	/people/arc/packages/guake.git
> 
> "необходимо создать пустой локальный репозиторий"
> Ок. Только не хочу я в домашнем каталоге.
> 
> arc@arc-laptop ~ $ mkdir -p ~arc/Documents/ALTLinux/devel
> arc@arc-laptop ~ $ cd ~arc/Documents/ALTLinux/devel
> arc@arc-laptop ~/Documents/ALTLinux/devel $
> 
> arc@arc-laptop ~/Documents/ALTLinux/devel $ git init
> Initialized empty Git repository in /home/arc/Documents/ALTLinux/devel/.git/
> 
> "Закоммитить в него нужное содержимое"
> Ок. Но в примере ОДИН файл. Если весь каталог то "*"?
> 
> Да и что мне заряжать в git для сборки пакета? Скелет RPM?
> _______________________________________________
> devel-newbies mailing list
> devel-newbies/lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/devel-newbies

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [devel] q: [[git.alt]] с применением gear-*/girar-* (was: [newbies] путь пакета в сизиф)

[Денис Смирнов]

[-- Attachment #1: Type: text/plain, Size: 1012 bytes --]

On Wed, Jan 27, 2010 at 12:39:42PM +0200, Michael Shigorin wrote:

MS> - упоминать только высокоуровневые утилиты, описывая их
MS>   функциональность и отправляя в ман-страницы либо исходники
MS>   за деталями (но там не всегда обозримо);
MS>   + pro: более краткие и читабельные страницы
MS>   + contra: отдаление от понимания происходящего

Не согласен. Отсылать к man-страницам из wiki это плохо. Идеальная
документация состоит из справочника (man сраницы), и собственно
документации -- tutorial и HOWTO, которые легче поддерживать на wiki.

MS> - переименовать текущую страницу в "техническое руководство",
MS>   а в качестве "краткого руководства" описать утилиты.
MS>   + pro: документированность высокого и низкого уровня
MS>   + contra: ?

Предлагаю выделить страничку HOWTO с рецептами, а также сделать tutorial
-- отдельно по git, отдельно по git.alt.

-- 
С уважением, Денис

http://freesource.info
----------------------------------------------------------------------------

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [devel] q: [[git.alt]] с применением gear-*/girar-*

[Dmitry V. Levin]

[-- Attachment #1: Type: text/plain, Size: 203 bytes --]

On Wed, Jan 27, 2010 at 03:15:11PM +0300, Денис Смирнов wrote:
> Не согласен. Отсылать к man-страницам из wiki это плохо.

Если эти man-страницы доступны по http, то не так уж и плохо.


-- 
ldv

[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]