[docs] HeapCheck v.0
Kirill Maslinsky
kirill на altlinux.ru
Вт Фев 15 13:35:53 MSK 2005
Привет!
> > 1. Поле(я) Author: заполнено на языке, указанном в поле Language:
> > (хотя бы в соответствующей кодировке).
> Какое отношение имеет одно к другому? Имя автора надо писать в
> наиболее понятном формате, а не транскрибировать насильно. конечно, если
> документ на русском языке, то и имя автора _в нём_ транскрибировано --
> как бог на душу переводчику положит. Но у Автора есть право ниписать имя
> так, чтобы всем понятнее было.
Вообще говоря, имена авторов включаются в документ в конечном формате
(например, в книжке), и составляют часть документа (титульного листа).
Довольно странно видеть в русскоязычной книге имя автора латиницей
без достаточных оснований (особенно если это записанное латиницей
русское имя). Если требуется сохранить оригинал имени переводного
автора, предлагаю писать его в скобках
Author: Ричард Столлман (Richard Stallman)
Таким же образом предлагаю указывать сведения о переводчиках, редакторах
и т. д. и т. п.
Вывод: автоматически лучше это не проверять, вставлю в виде словесных
рекомендаций в sample.docinfo.
> > 2. В поле License: содержится одна из строк GPL/FDL/distributable
> Больше лицензий не бывает? Это ведь документаци, на неё самые
> удивительные требования случаются. А тексты нам нужны.
Мы вписали, что у нас репозиторий _свободной_ документации.
А это уж значит, что каким-то образом distributable; точные
условия распространения указываются в файле License, а не в
docinfo, для того этот файл и заведён. Указание лицензии
в краткой стандартной форме нужно для Морды Кучи, чтобы в
списке документов отображать только одно маленькое слово,
а не полный текст License, который может оказаться весьма
длинным. А полный License отображать по специальному
запросу уже для конкретного отдельного документа.
> > 3. Если нет поля Url: -- создать его в паспорте в нормализованном архиве,
> > вписав туда url: документа в самой Куче (документ имеет право иметь Кучу
> > в качестве upstream)
> Только в том случае, если это какой-то другой документ. Иначе
> получится вечный цикл при понижении информативности.
Ну ладно. Тогда в модуле (rpm-пакете) нужно будет ставить url
из Кучи, если другого нет.
> > 5. Выбрано хотя бы одно поле Section: (и в нём значение из списка, а не
> > левое какое-нибудь). Можно потребовать, чтобы в каждой категории, кроме
> > "Специфичность" был выбран хотя бы один признак.
> Пока это обсуждается.
А где? Может, тут обсудим, я предложил вполне конкретное решение.
--
Kirill Maslinsky
ALT Linux Documentation Team
Подробная информация о списке рассылки docs