Quoting from the xs3p web site...
* It provides links that allow the user to jump to the documentation of schema components that are referenced.
* It provides a view of schema components' constraints as a sample XML instance.
* For global type definitions, it shows the super- and sub- types of the type definition.
* For global element declarations, it shows the substitution groups that the element declaration heads or belongs to.
* It can sort schema components by type and name.
* It has a glossary section which explains some XML Schema terminology.
Their wiki is also quite useful though I could not get the link generator XSLT to work.
The output looks quite nice too...
The generated documentation is fully hyperlinked and easy to navigate. This definitely makes a XSD much easier to comprehend.
So to do this, I had to generate a links.xml file that described which XSDs map to which HTML output files. This is really straight forward, just put in the XSD file name along with its HTML file which you generate later. For example...
I had an entry for every XSD file in my whole schema.
Now all I had to do was to run xsltproc to generate my output. This is done for every XSD file and looks something like this (though I created a shell script to do it for me)...
Note the naming of the output file, it's simply the XSD file name with .html at the end of it and that's exactly what the links.xml file contains as well.
Do this for all the XSD files in your schema and your documentation will be complete.