Is to good to add a view to list user guide in component description?

[Justin Huang]

I'd like to describe IP documents, e.g., user guide, in IP-XACT XML file.

I did not find any example showing how to describe docs in IP-XACT XML, I added a Documentation view, documentation componentInstantiation and fileSets as shown below, is it recommended way?

 

<ipxact:component ...>
    ...
    <ipxact:model>
        <ipxact:views>
            <ipxact:view>
                <ipxact:name>Documentation</ipxact:name>
                <ipxact:envIdentifier>::</ipxact:envIdentifier>
                <ipxact:componentInstantiationRef>documentation</ipxact:componentInstantiationRef>
            </ipxact:view>
        </ipxact:views>
        <ipxact:instantiations>
            <ipxact:componentInstantiation>
                <ipxact:name>documentation</ipxact:name>
                <ipxact:fileSetRef>
                    <ipxact:localName>UG</ipxact:localName>
                </ipxact:fileSetRef>
            <ipxact:componentInstantiation>
        <ipxact:instantiations>
    </ipxact:model>
    <ipxact:fileSets>
        <ipxact:fileSet>
            <ipxact:name>UG</ipxact:name>
            <ipxact:file>
                <ipxact:name>docs/xxx_user_guide.pdf</ipxact:name>
                <ipxact:fileType user="pdf">user</ipxact:fileType>
            </ipxaxct:file>
    </ipxact:fileSets>
    ...
</ipxact:component>

[kock]

Hello Justin,
Yes, this is the way it should be done.
Best regards,
Erwin