Requirements for Metanorma to process documentation for XSD in adoc

[Intelligent2013]

In order to generate documentation for XSD, XML object parser in Metanorma should support:

• process xml namespaces
  • setup namespaces
  • specify namespaces in element names, like xsd:element
• specify XPath expressions, it is necessary for these features:
  • iterate all nested elements xsd:element independent of depth, for example xsd:schema//xsd:element allows to select xsd:element in structure like xsd:schema/xsd:complexType/xsd:sequence/xsd:element;
  • access to ancestor element, for example ancestor::xsd:complexType/@name allows to know the type which uses this element/attribute;
  • find nodes by condition, for example //*[@type = $typename] - find nodes with attribute type equals to value from variable typename,
• support {%include ... %} feature with parameters like this: {% include_relative typeref.adoc ref=type %} - pass named parameter ref with value type into module typeref.adoc (example you can see here: https://raw.githubusercontent.com/unitsml/schemas/xsd_liquid/adoc/index.adoc)

[opoudjis]

My only reaction to all of this: I shouldn't be the one doing this, this should be a lutaml plugin or equivalent. (A lutaml preprocessor?) I nominate @w00lf. But then, I would...

[ronaldtse]

This is to be implemented in metanorma/metanorma#203.