[docs] Как нам реорганизовать heap

Kirill Maslinsky =?iso-8859-1?q?kirill_=CE=C1_altlinux=2Eorg?=
Пн Окт 6 12:16:46 MSD 2008


On Sun, Oct 05, 2008 at 08:32:10PM +0700, Mikhail Gusarov wrote:
> Twas brillig at 16:26:58 05.10.2008 UTC+03 when artem.zolochevskiy на gmail.com did gyre and gimble:
> 
>  AZ> Кое-какой опыт очень даже понравился (fedorа-шный).
> 
> URL?
> 
>  AZ> - разнобой входных форматов влечёт ужасный вид результирующего html
>  AZ> (стоит посмотреть на любой выпуск документации)
> 
> Это исправлябельно per-format. Кроме того, можно на некоторые форматы
> слегка "положить" и рекомендовать (не заставлять) использовать тот же
> docbook.

Для справки: 
$ ssh git.alt find-package docs-* | cut -f 1 | xargs -I{} git-clone git.alt:{}
$ find */docinfo -type f -exec fgrep Format {} \; | cut -f2 -d " "| sort | uniq -c | sort -nr
     64 m-k
     54 DocBook/XML
     16 ODT
      9 html
      4 ODS
      4 DokuWiki
      2 XML
      2 m-k:
      1 xml
      1 tex
      1 plain
      1 OOo
      1 odt
      1 HTML

Я считаю перспективными форматами, которые нужно поддерживать и
вылизывать per-format как минимум следующие три: m-k, docbook, ODT.
Обсуждать, какие ещё форматы надо бы поддерживать, будет иметь
смысл после того, как хотя бы эти три будут поддерживаться на 
нормальном уровне. 

Я считаю неперспективными форматами, документы в которых не должны
входить в основной пакет документации, как минимум два: html и plain
text.

-- 
Kirill Maslinsky
ALT Linux Team
----------- следующая часть -----------
Было удалено вложение не в текстовом формате...
Имя     : =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Тип     : application/pgp-signature
Размер  : 189 байтов
Описание: =?iso-8859-1?q?=CF=D4=D3=D5=D4=D3=D4=D7=D5=C5=D4?=
Url     : <http://lists.altlinux.org/pipermail/docs/attachments/20081006/c1fe0e2c/attachment.bin>


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