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

[Jirka Kosek <jirka@kosek.cz>]

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: jirka@kosek.cz     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.
------------------------------------------------------------------

S/MIME Cryptographic Signature