"Non-specialist" readable versions of schema files
Posted: Wed May 18, 2011 11:39 pm
Our project has a moderate number of schema files, including type definitions and the main elements used by our developers.
Is it (fairly easily) possible to generate some human readable document that summarizes the main XML elements used by our developers?
They don't need to see all of the schema definitions, but mainly the ones they use daily to develop our XML files.
Some time ago, someone tried using XML Spy XSLT Designer to generate a stylesheet that would display elements in a tabular HTML format.
We're using Oxygen now, and I was wondering whether there was some existing feature that helps generate user documentation from schema files.
Our developers are using XML to write our source, but would not generally be skilled at reading and interpreting the "raw" schema files.
They'd like to know what main elements have been defined, and what attributes and sub-elements are associated with the main elements.
Oxygen auto-completion helps, but some would like to see ahead of time all of the attributes and sub-elements without having to try to expand elements, trial-and-error like, with the auto-completion.
We are not using FO or anything similar. Just basic schema and transformation files used by developers to write XML files to be processed.
Suggestions?
Thanks, Mike
Is it (fairly easily) possible to generate some human readable document that summarizes the main XML elements used by our developers?
They don't need to see all of the schema definitions, but mainly the ones they use daily to develop our XML files.
Some time ago, someone tried using XML Spy XSLT Designer to generate a stylesheet that would display elements in a tabular HTML format.
We're using Oxygen now, and I was wondering whether there was some existing feature that helps generate user documentation from schema files.
Our developers are using XML to write our source, but would not generally be skilled at reading and interpreting the "raw" schema files.
They'd like to know what main elements have been defined, and what attributes and sub-elements are associated with the main elements.
Oxygen auto-completion helps, but some would like to see ahead of time all of the attributes and sub-elements without having to try to expand elements, trial-and-error like, with the auto-completion.
We are not using FO or anything similar. Just basic schema and transformation files used by developers to write XML files to be processed.
Suggestions?
Thanks, Mike