XML documenting tool that outputs both schema and MS Word doc

[DayLaborer]

I need to document the XML which a C# webservice will be accepting and returning. I need to produce two types of documentation:
1) an actual XML schema that we will use to validate our XML
2) a Microsoft Word doc explaining each node

Is there some sort of (freeware) tool that will help me accomplish this?

Thanks,
Eliezer

 

[Diancecht]

Here is a DTD generator

Cheers,
Dian

 

[DayLaborer]

Thanks. That will generate a schema from my XML file. That is good. But how about something to generate easily readable documentation for humans to read?

 

[Diancecht]

I don't think there's such a tool, as the documentation involves introducing human readable information that must be provided by a human

Cheers,
Dian

 

[DayLaborer]

Dian, it's good to know we're not obsolete. Yet.

Eliezer

 

[DayLaborer]

OK, I've added

<xs:annotation>
    <xs:documentation>Blah-blah-blah</xs:documentation>
</xs:annotation>

tags to my form. Now how can I display that documentation in a readable fashion?

Thanks,
Eliezer

 

[DayLaborer]

...one more question: if I want to include a block of XML in my schema's annotation / documentation nodes, is there a special way to do it, or just sandwich it between <annotation> and <documentation> tags?

Thanks again,
Eliezer

 

[Diancecht]

Dian, it's good to know we're not obsolete. Yet.

I'd rather prefer not having to document but yes, it nice to know there's still something we can do.

Maybe this helps.

Cheers,
Dian