Re: [docbook-tc] The first draft of DB5 how-to

From
Jirka Kosek
Date
2005-10-10T19:20:00+00:00
ID
Thread
Re: [docbook-tc] The first draft of DB5 how-to
MHonArc v2.5.0b2 -->



















docbook-tc message






[Date Prev]
 | [Thread Prev]
 | [Thread Next]
 | [Date Next]

--

[Date Index]
 | [Thread Index]
 | [List Home]








Subject: Re: [docbook-tc] The first draft of DB5 how-to




From: Jirka Kosek <>
To: Norman Walsh <>
Date: Mon, 10 Oct 2005 21:19:29 +0200






Norman Walsh wrote:

> | I will really appreciate if some native speaker can do proofreading. Any
> | volunteers?
> 
> I'll do a once-through for English grammar.

Thanks.

> | Extensive section about customizations is missing, I might have time for
> | finishing it during the next month.
> 
> I'll try to convert the relevant chapter of TDG soon.

Great.

> | * Draft of DocBook V5.0 specification points to address http://docbook.org/rng/
> | where schemas should be, but aren't.
> 
> We don't have any official 5.0 schemas to point to yet.

Yes, I know. I just wanted to raise issue to make sure that we will not 
forget to correct it before release.

> | * We should decide on locations where particular schemas (DTD, RNG,
> |   WXS) will be available and mention these locations in how-to.
> 
> True. I suppose the consistent thing to do would be to leave them under /xml.

But we already have /xsd and /rng for WXS and RNG variants of V4.x XML 
DTD. Wouldn't it be something like

http://docbook.org/schemas/5.0/docbook.rng
http://docbook.org/schemas/5.0/docbook.rnc
http://docbook.org/schemas/5.0/docbook.xsd
http://docbook.org/schemas/5.0/docbook.dtd

better?

Another idea is to have URI that will always provide the most current 
version of schemas. Something like:

http://docbook.org/schemas/docbook.rnc

or

http://docbook.org/schemas/latest/docbook.rnc

However I haven't been thinking much about it yet, so there could be 
some negative consequences of such arrangement.


-- 
------------------------------------------------------------------
   Jirka Kosek     e-mail:      http://www.kosek.cz
------------------------------------------------------------------
   Profesionální školení a poradenství v oblasti technologií XML.
      Podívejte se na náš nově spuštěný web http://DocBook.cz
        Podrobný přehled školení http://xmlguru.cz/skoleni/
------------------------------------------------------------------
   Nejbližší termíny školení: DocBook 5.-7.12. * XSL-FO 19.-20.12.
      XSLT 17.-20.10. * XML schémata (včetně RELAX NG) 7.-9.11.
------------------------------------------------------------------