api-doc-tools icon indicating copy to clipboard operation
api-doc-tools copied to clipboard

Add XSD to all monodoc XML as they are generated

Open lobrien opened this issue 8 years ago • 1 comments

The root element of the monodoc XML should specify the monodoc-ecma.xsd:

<Type Name="Foo" FullName="Bar.Foo" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://github.com/mono/api-doc-tools/mdoc/Resources/monodoc/1.0/monodoc-ecma.xsd">...</Type>"

(I am not sure about best practice for the schema. I think it's something like the above: $"{base}/{schemaname}/{semantic MAJOR.MINOR}/{xsdfile}" but I may be wrong.)

lobrien avatar Apr 21 '17 21:04 lobrien

Github asks you to avoid linking directly to files for "production" use ... so if we were going to do this, we'd want to host these XSD files somewhere.

joelmartinez avatar Apr 24 '17 14:04 joelmartinez