xs3p icon indicating copy to clipboard operation
xs3p copied to clipboard

Nested documentation nodes

Open MaximilianKresse opened this issue 8 years ago • 0 comments

The problem:

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="http://www.setasign.com/Konquadrat/Dashboard"
            xmlns="http://www.setasign.com/Konquadrat/Dashboard"
            elementFormDefault="qualified">

    <xsd:element name="dashboard" type="dashboard"/>

    <xsd:complexType name="dashboard">
        <xsd:sequence>
            <xsd:choice minOccurs="0" maxOccurs="unbounded">
                <xsd:element name="diagramWidget" type="rectWidget"/>
            </xsd:choice>
        </xsd:sequence>
    </xsd:complexType>

    <xsd:complexType name="diagramWidget">
        <xsd:annotation>
            <!-- Works fine! -->
            <xsd:documentation>...</xsd:documentation>
        </xsd:annotation>
        <xsd:all>
            <xsd:element name="x" type="xsd:integer" minOccurs="0">
                <xsd:annotation>
                    <!-- Works fine! -->
                    <xsd:documentation>...</xsd:documentation>
                </xsd:annotation>
            </xsd:element>
            <xsd:element name="colors" minOccurs="0">
                <xsd:annotation>
                    <!-- Works fine! -->
                    <xsd:documentation>...</xsd:documentation>
                </xsd:annotation>
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="color" type="xsd:normalizedString" maxOccurs="unbounded">
                            <xsd:annotation>
                                <!-- DOESN'T WORK! -->
                                <xsd:documentation>...</xsd:documentation>
                            </xsd:annotation>
                        </xsd:element>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:all>
    </xsd:complexType>
</xsd:schema>

The documentation block in diagramWidget//colors//color will not be found by the template hiddendoc. And so the modal window for this will not be generated. The (i) button will be shown for this node but nothing happens if you click on it.

This behavior can be observed for all nested documentation blocks.

MaximilianKresse avatar Aug 11 '17 07:08 MaximilianKresse