[docs] Re: Primary tasks [IMHO]

[bloodmary]

День добрый, господа!

Прошу прощения, но позвольте задать несколько глупых вопросов.

1. Складывается ощущение, что форме организации документации уделяется 
намного больше внимания, нежели ее (документации) содержимому - это 
печально.
Помимо структуры еще хотелось бы "бороться" с содержанием. Или такой 
подход неправомерен?


Vitaly Ostanin пишет:

>On Tue, 25 Feb 2003 12:46:18 +0300
>Alexandre Prokoudine <avp на altlinux.ru> wrote:
>
>  
>
>>On Tue, 25 Feb 2003 12:35:13 +0300
>>Vitaly Ostanin <vyt на vzljot.ru> wrote:
>>
>>    
>>
>>>Hello, All!
>>>
>>>Тут назрело очередное IMHO :)
>>>
>>>1.
>>>Есть предложение сформировать структуру для сбора документов
>>>в книги, отдельную от самих документов. 
>>>
>>>То есть собрать доки из openoffice и junior и разложить в
>>>user, после чего сделать отдельный каталог (например,
>>>releases, books), в котором и собирать документы в готовые
>>>книги. Книги нужно называть полностью, с указанием версии
>>>дистрибутива, например, master-2.2-admin, master-2.2-user и
>>>т.д., а ещё лучше master-2.2, под которым сложить admin, user
>>>и т.д. 
>>>      
>>>
>>То есть сделать ещё одну копию всех исходников в XML? Или я
>>неправильно тебя понял?
>>    
>>
>
>Нет, оставить по смыслу admin, user, install, alt, а готовые
>книги для дистрибутивов собирать в отдельных каталогах. Недавно
>об этом Антон писал.
>
>  
>
>>>Переменную с названием текущего дистрибутива (DISTRO,
>>>CURRENT_DISTRO) можно вынести в отдельный набор сущностей,
>>>что-то вроде
>>>"-//ALTLINUX//ENTITIES Variables Documentation//RU"
>>>(не могу нормальное название придумать)
>>>и переопределять этот набор при сборке готовой книги (libxml2
>>>это позволяет, надо протестировать)
>>>
>>>2.
>>>Что с BTS? Если уже можно, то как?
>>>      
>>>
>>Я подготовлю список "пакетов" и отдам Zerg'у. После этого можно
>>будет работать с ними как с обычными пакетами - "вешать баги,
>>фичи" и пр.
>>
>>пакет = документ
>>    
>>
>
>У... Много будет. Давайте пакет = каталог ?
>
2. Даже можно 1 байт = каталог. Проблема еще и в другом. Пример 
насущный: в Howtos-Russian есть некий Hardware-Howto (в переводе 
Александра Михайлова) - 1999 года изготовления. Информация, изложенная в 
документе, устарела на ~ 85 % и имеет весьма условное отношение к 
дистрибутивам ALT. Плюс к этому - тьма  орфографических и грамматических 
ошибок. Все это любезно предоставляется на всеобщее обозрение... 
Печально. Вопрос: можно ли здесь хоть что-то изменить?

>
><skipped/>
>  
>

3. Еще раз прошу прощения за собственную неосведомленность, но может ли 
хоть кто-то дать вразумительный ответ на вопрос о принципах включения 
русскоязычной документации формата man, info, howto?

----------- следущая часть -----------
Вложение в формате HTML было удалено...
URL: /pipermail/docs/attachments/20030225/03129b8b/attachment.htm