[platform-ua-dev] Intro content schema

["pierre _" <pican123@xxxxxxxxxxx>]

Hi,
while trying to author "intro content" files in an XML editor, I ran into 
several problems with the IntroContent.exsd schema file found in the 
org.eclipse.ui.intro plugin.

N.B.: my comments are based on Eclipse 3.2 RC7. But looking at the revision 
log, some of these problems date back to Eclipse 3.0.

1) the schema is not valid
- the <appInfo> element doesn't exist. <appinfo> does.
- the 'default' value is not allowed for the "use" attribute. It should be 
replaced by the 'optional' value.
- the "value" attribute is not allowed in an <attribute> element. It should 
be replaced by a "default" attribute.
- XML Schema elements should be in the XML Schema namespace.
- the 'string' and 'boolean' primitive data types should be in the XML 
Schema namespace.
- if the elements declared in the target namespace remain unqualified, then 
there should be a xmlns="org.eclipse.ui.intro" in the <schema> root element.

2) either the schema is wrong or most, if not all, of the intro content 
files in Eclipse are not valid:
- according to the schema, an <introContent> element must have at least one 
<page> child.
the <introContent> element in org.eclipse.platform/intro/overviewEx.xml, for 
instance, doesn't.

- according to the schema, a <text> element is supposed to be empty. Yet, 
its description is:
"a snippet of text that can optionally contain escaped HTML tags. It can 
include b and li tags. It can also contain anchors for urls. If multiple 
paragraphs are needed, then the text can be divided into multiple sections 
each beginning and ending with the p tag."
<text> elements in org.eclipse.platform/intro/overviewEx.xml, for instance, 
contain text nodes.

- the <title> element has a similar problem
<title> elements in org.eclipse.ui.intro.universal/introContent.xml contain 
text nodes.

- according to the schema, the"id" attribute of an <img> element is required
<img> elements in org.eclipse.ui.intro.universal/introContent.xml don't have 
an "id" attribute.

- if I understand the definition of <group> and <page> elements in the 
schema correctly, it means:
"should a <page> (or <group>) element contain more than one child element, 
all children element must be of the same type".
<page> elements in org.eclipse.ui.intro.universal/introContent.xml contain 
<anchor>, <title> and <group> elements.
the "page-content" <group> elements in 
org.eclipse.ui.intro.universal/introContent.xml contain <text> and <group> 
elements.

Do you think there's time for these problems to be fixed before Eclipse 3.2 
is released at the end of June?

Regards,
Pierre