This is my suggested structure:
/readme.html (or index.html) /catalog.xml (XML catalog for using schemata) /license.html (your licensing) /schemas/ youschemas.xsd otherschemas.xsd somemodule-0.1/ module.xsd /doc/ index.html (general intro) reference/ index.html (schema reference - xsddoc) /examples guide.html (guide to samples) sample1.xml sample2.xml ...