The design, structure and translation

Osamu Aoki | 2 Nov 2003 18:19

Re: Naming schemes of DDP documents

On Sun, Nov 02, 2003 at 06:25:28PM +0100, Frank Lichtenheld wrote:
> Hi.
> 
> While checking links on www.debian.org I spotted a problem
> with the DDP documents listed on www.debian.org/doc. There
> exist at least to naming schemes for languages with a "sublanguage"
> (like pt_BR and zh_TW):
> 
> 1.) xx-xx for all formats
> 	(i.e. <manual>.pt-br.{html,ps,pdf,txt})
> 2.) xx-xx for html and xx_XX for all other formats 
> 	(i.e. <manual>.pt-br.html but <manual>.pt_BR.{txt,ps,pdf})
> 
> This causes some dead links on www.debian.org.
> I wonder on which site this should be fixed? There are three possibilities:

Old discussion which we have no solid conclusion/

> 1.) use naming scheme 1 for all documents and file bugs against
> non-conforming ones
> 2.) dito, but use scheme 2
> 3.) let support www.debian.org/doc/ support both schemes
> 			
> Which one is it? (I can take care myself of 3 or file the bugs related 
> to 1 or 2)
> 
> Gruesse,

We need to agree not just these but many more for consistency.

(Continue reading)

headers

Frank Lichtenheld | 2 Nov 2003 20:30

Re: Naming schemes of DDP documents

On Sun, Nov 02, 2003 at 06:19:17PM +0100, Osamu Aoki wrote:
> On Sun, Nov 02, 2003 at 06:25:28PM +0100, Frank Lichtenheld wrote:
> > [...]
> > 1.) use naming scheme 1 for all documents and file bugs against
> > non-conforming ones
> > 2.) dito, but use scheme 2
> > 3.) let support www.debian.org/doc/ support both schemes
> > 			
> > Which one is it? (I can take care myself of 3 or file the bugs related 
> > to 1 or 2)
> 
> We need to agree not just these but many more for consistency.
> 
> I like 1) but if 2) is chosen, we may do like
>   <manual>.pt_BR.ISO-8859-1.{txt,ps,pdf}
>    or
>   <manual>.pt_BR.UTF-8.{txt,ps,pdf}
> [...] 
>  http://www.debian.org/doc/manuals/ddp-policy/ddp-policy.en.html
>   and see
>  http://www.debian.org/doc/manuals/ddp-policy/

Ok, if I interpret your mail (and the ddp policy draft )correctly 
the answer is actually
"I like 1, and that also what's in the ddp-policy draft. But
bug reports are not quite good, because there is no consensus yet
and the policy is still a draft". Correct me if I got anything
wrong.

Based on this I will propose a patch for the www pages which enables

(Continue reading)

headers

Frank Lichtenheld | 3 Nov 2003 12:18

Patch (was: Re: Naming schemes of DDP documents)

On Sun, Nov 02, 2003 at 08:30:54PM +0100, Frank Lichtenheld wrote:
> Ok, if I interpret your mail (and the ddp policy draft )correctly 
> the answer is actually
> "I like 1, and that also what's in the ddp-policy draft. But
> bug reports are not quite good, because there is no consensus yet
> and the policy is still a draft". Correct me if I got anything
> wrong.
> 
> Based on this I will propose a patch for the www pages which enables
> them to support both naming schemes. This will at least give the users 
> correct links...

Patch attached. Comments welcome.

Gruesse,
--

-- 
Frank Lichtenheld <frank <at> lichtenheld.de>
www: http://www.djpig.de/

Index: devel-manuals.wml
===================================================================
RCS file: /cvs/webwml/webwml/english/doc/devel-manuals.wml,v
retrieving revision 1.24
diff -u -r1.24 devel-manuals.wml
--- devel-manuals.wml	29 Jan 2003 06:26:23 -0000	1.24
+++ devel-manuals.wml	3 Nov 2003 11:14:52 -0000
 <at>  <at>  -121,7 +121,7  <at>  <at> 
   <availability>
   <inpackage "maint-guide">

(Continue reading)