[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