Broken links in HTML documentation

[JSMAUG]

The HTML created from a self contained .xsd contains many broken links, especially in the "Schema Component Representation" and the "XML Instance Representation". The same links work when they appear in other sections. For example, a bad super type link in the "XML Instance Representation" is bracketed by a working super type link below the complex type heading and a diagram created from a link to the same super type.

What are we missing?

[sorin_ristache]

Hello,

Can you post a sample schema for this problem?


Regards,
Sorin

[JSMAUG]

Sorin,

The following can be used to demonstrate the HTML documentation problem. "BranchBaseAttributesType" and "string30 are resolved for some things but not others." They are fine in the xml editor. The behavior is the same on the developer's fully licensed copy and my 8.2 trial copy. We have been using Oxygen for writing xml, but this is our first venture into documenting it.

Thanks

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation id="OverallDescription">
<xs:documentation xml:lang="en">
This is a schema for demonstrating the link problem.
</xs:documentation>
</xs:annotation>

<!-- BRANCHES -->
<xs:complexType name="BranchBaseAttributesType">
<xs:sequence>
<xs:element name="UserFieldValue" minOccurs="0" maxOccurs="1" type="xs:string" />
</xs:sequence>
<xs:attribute name="UID_BUse" type="string30" />
<xs:attribute name="BranchID" type="string30"/>
<xs:attribute name="Name" type="string30"/>
<xs:attribute name="Sections" type="string30" />
<xs:attribute name="Comments" type="string30" />
<xs:attribute name="SYS_AreaAdjustment" type="string30" />
<xs:attribute name="SYS_Area" type="string30" />
</xs:complexType>

<xs:complexType name="BranchType">
<xs:complexContent>
<xs:extension base="BranchBaseAttributesType">
<xs:sequence>
<xs:element name="SectionsCollection" type="xs:string" minOccurs="0" maxOccurs="1" />
</xs:sequence>
<xs:attribute name="UID_BUniqueID" type="string30" />
</xs:extension>
</xs:complexContent>
</xs:complexType>

<xs:simpleType name="string30" id="string30">
<xs:restriction base=" xs:string ">
<xs:maxLength value="30"/>
</xs:restriction>
</xs:simpleType>

</xs:schema>

[sorin_ristache]

Hello,

Yes, the links to the type definitions for BranchBaseAttributesType and string30 are broken in Schema Component Representation and in XML Instance Representation. We will fix the problem in a future version of oXygen.


Thank you,
Sorin

[sorin_ristache]

Hello,

We fixed the broken links in the generated XML Schema documentation. The improved generator of the schema documentation will be included in the next version of Oxygen (version 10.1).


Regards,
Sorin