[docs] проблемы модульной документации

Artem Zolochevskiy artem.zolochevskiy на gmail.com
Вт Янв 29 11:16:06 MSK 2008


В сообщении от Monday 18 June 2007 17:46:14 Fr. Br. George написал(а):

> > 1. Смириться с тем, что к примеру, в Сизифе невозможно иметь докуменацию
> > на тот или иной выпуск дистрибутива (в том же виде в котором она туда
> > попала). Ну не искать же в архиве именно те версии что были тогда и
> > ставить их вручную...
> > Очевидно, что этот вариант работает при условии разделения репозиториев.
> > 3.0 отдельно, 4.0 - отдельно, 5.0 - отдельно ;-)
>
> Ну так так это и делается. Они и есть все отдельно.
>
> > Получить документацию на конкретный дистрибутив из Сизифа в этом случае
> > _невозможно_.
>
> А зачем? Эта документация _не будет_ описывать Сизифа. Ведь нельзя же из
> Сизифа получить, допустим, Qt2 -- но это не волнует даже того, кому Qt2
> нужен.

Это не работает с docs-issue, которые являются например печатными книжками. 
Т.е. на какой-то момент времени они отображали печатную версию. А теперь -- 
показывают непонятно что. Ещй есть issue по дистрибутивам, которые не попали 
в рапозитории-аорхивы, откуда всегда можно видеть их пераородное состояние 
(пример -- docs-issue-desktop_edu)

> > Тогда нужно помнить, что все docs-issue-...  в Сизифе отбражают
> > документацию непонятно на что.
>
> Угу, на Сизиф. Вернее, на соответствующий класс дистрибутива, если бы его
> собрали из Сизфа прямо сейчас. И это правильно, между прочим. Повышент
> вероятность, что обратная связь по ошибкам в документации будет
> действенной.
>
> > Потому как совсем непонятно какие версии
> > модулей, составляющих конкретный docs-issue- установлены.
>
> Последние.

Это снова не работает, Если мы говорим об docs-issue, которые НЕ относяткя к 
дистрибутивам

-- 
Артём Золочевский


Подробная информация о списке рассылки docs