[docs] Re: Literate programming for Makefiles

[Vitaly Ostanin]

On Tue, 4 Nov 2003 20:05:57 +0300
"Oleg A. Paraschenko" <olpa на xmlhack.ru> wrote:

<skipped/>

> > > > > Я понял аргумент про рекурсивный идеализм, но это не
> > > > > тот случай:)
> > > > 
> > > >   Самый что ни на есть. За то время, которое мы уже
> > > >   потратили на Makefiles, можно было написать k док и
> > > >   сделать m скриншотов,
> > 
> > Ещё раз на тему этого абзаца, который мне неприятен:
> 
>   Извиняюсь за грубость. Но это была конкретная
>   переформулировка словоблудия про основной и поддерживающие
>   процессы. Это такое напоминание, чтобы не забылась основная
>   цель.

Хорошо, я не забуду, как не забывал и раньше :)

> > Во-первых, я не жалею об этом времени (своём).
> 
>   Поэтому-то мы этим всем и занимаеся, не так ли?
> 
> > Во-вторых, могу
> > напомнить, по чьей инициативе я его потратил на переделку
> > Makefiles.
> 
>   Про literal programming я ничего не говорил :-)

Не говорил.

> > > В общем, я согласен с Олегом. Действительно практически вся
> > > активность сдесь сосредоточена на инструментарии, а не на
> > > содержании :(
> > 
> > Какие будут предложения? Наделать m скриншотов? Встанет
> > вопрос, к какой доке, куда приложить усилия. То есть должен
> > быть список документов со статусом.
> 
>   Да! Проект без плана обычно мёртв.
> 
> > То есть он должен создаваться каким-то
> > инструментарием...
> 
>   План не надо создавать инструментарием. Он просто должен
>   быть.

Ручная выборка и сортировка кучи модульных документов без
инструментария нереальна.

> > Сейчас я выбираю приоритеты работы над docs@, руководствуясь
> > своим интересом и наличием времени. Если есть конкретная
> > программа действий, я с удовольствием выслушаю - это не
> > сарказм.
> 
>   Во! В точку. И эта программа должна быть на главной странице
>   проекта alt-docs (offtopic: например, в wiki). Далее всё --
>   отсебятина.

Необходимость плана несколько раз обсуждалась, можно поискать в
архивах. Вкратце - да, нужен, я пилю умножение сущностей под
названием document-info с мета-информацией о документе, в том
числе с его статусом.

Wiki тоже обсуждался, и я был против в том смысле, что я не
считаю его живучим средством упорядочивания информации и я его не
буду делать/поддерживать. Если кто-то возьмётся - здорово.

<skipped/>

-- 
Regards, Vyt
mailto:  vyt на vzljot.ru
JID:     vyt на vzljot.ru
----------- следущая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : отсутствует
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: отсутствует
Url     : /pipermail/docs/attachments/20031104/357c35e0/attachment.bin