[PATCH] XML Policy

[Frans Englich]

On Tuesday 22 February 2005 22:57, Jason Keirstead wrote:
> On February 22, 2005 06:09 pm, Frans Englich wrote:
> > So that's my motivation; the capitalization of XMLGUI is rare, and a
> > format would unliklely be designed like that.
>
> What makes you think that? I have seen countless XML formats with
> capitalized tag names. Where do you get these statistics?
>
> > But you think that's wrong; e.g,
> > what you mean is we should be consistent with XMLGUI, not with the
> > general style of KDE. Right?
>
> No, what I mean is that there should not be a guideline for this.. 

And that's the only possible outcome in either case, so no such guideline, as 
you say.

<snip>

> > Again, re-read. I specifically left out vocabularies which are internal.
> > That paper is here only for the reasons you mention. Read it.
>
> Well, maybe you should specify that in the document then?

Yes, here could use some corrections.

>
> "This policy specifies recommendations and conventions for XML related
> technologies in KDE."

It's a bit difficult to cover all details in an introductory paragraph, but is 
"This policy contains recommendations for the use of XML within KDE, as well 
as conventions for XML technologies part of KDE's public interfaces." better?

>
> Nowhere in the document does it say that 'The recommendations in this
> document apply only to XML APIs that are deemed to be noteworthy to third
> party application developers. you go on a bit about public namespaces, but
> the second on Element and Attribute names is not in that  section, and
> neither is the section on XML schemas.

So, the "policy" now applies more for XML in general, but in the case of 
namespaces the spec says "This policy does not apply for application specific 
namespaces but leaves it to the developers in question." Do you think it 
should be clarified futher?

I've attached a new version, whose changes are:
* Comment on RELAX NG fixed(David)
* Changed introduction(Jason)
* No style convention(everyone)
* No RFC reference and toned it down(everyone)
(Have I missed something?)

Of couse, this is not set in stone, it's just a draft like the first was, 
further feedback can be suggested, and it be fixed again. From what I can 
tell, this should fix what people thought needed improvement. 

From the discussion so far it is of course implied that the document should 
not appear on developer.kde.org, but if the second draft fixes what people 
thought needed to be, they should not hesitate to drop a line. Is everyone 
happy? :)


Cheers,

		Frans
-------------- next part --------------
A non-text attachment was scrubbed...
Name: xmlpolicy.xhtml
Type: application/xhtml+xml
Size: 6353 bytes
Desc: not available
URL: <http://mail.kde.org/pipermail/kde-core-devel/attachments/20050223/410e80cc/attachment.xhtml>