It's not clear to me how we should organize the schematron that we want to write, since we have two distinct things (in distinct namespaces) that need to be checked. A few ideas:
The schematron for the configuration file lives in the ODD as <constraintSpec>s in the appropriate places, and we have a separate schematron file (staticSearchCollection.sch) for the HTML documents.
The schematron for the configuration file and the schematron for the document collection both live in the ODD with the document collection checks as a <constraintSpec> as a child of the <schemaSpec>. This would mean that all of the checks would be in the documentation
We do something complicated with multiple <schemaSpec>s in the single ODD—we could, then, conceivably have a full schema for the HTML documents and a schema for the config, both in the documentation.
1 has the advantage of being simplest, but I do think 2 is nice since it'd mean all of the constraints are appropriately documented (and thus any of that documentation would be easily searchable for any release).
It's not clear to me how we should organize the schematron that we want to write, since we have two distinct things (in distinct namespaces) that need to be checked. A few ideas:
<constraintSpec>
s in the appropriate places, and we have a separate schematron file (staticSearchCollection.sch
) for the HTML documents.<constraintSpec>
as a child of the<schemaSpec>
. This would mean that all of the checks would be in the documentation<schemaSpec>
s in the single ODD—we could, then, conceivably have a full schema for the HTML documents and a schema for the config, both in the documentation.1 has the advantage of being simplest, but I do think 2 is nice since it'd mean all of the constraints are appropriately documented (and thus any of that documentation would be easily searchable for any release).