Hej!
Jag har fått i uppdrag att göra en XML-beskrivning på ett antal XML-dokument.

Jag undrar om någon vet vad en sådan bör innehålla!?

är det alltså ett (eller flera) Xml Schema du ska göra?

det är flera

Beskrivningen (schemat) beskriver en klass av xml-dokument, d.v.s. vilka element och attribut som får förekomma i ett dokument som tillhör klassen och deras relationer till varandra. Schemat används sedan för att avgöra att ett dokument tillhör klassen (är giltigt enligt schemat).

Sen måste du veta vilket schemaspråk du ska använda, detta beror på i vilket sammanhang dina scheman ska användas. Fråga uppdragsgivaren. De alternativ som finns är DTD (Document Type Definition), som är en del av XML-specifikationen; W3C XML Schema, som kommer från W3C och som använder XML-syntax för att beskriva en dokument-klass. XML schema anses dock av ledande XML-experter som onödigt komplext, buggigt och allmänt bristfälligt, så om det är ett alternativ så skulle jag rekommendera att du tittar på Relax NG som kommer allt starkare nu allt eftersom folk börjar tröttna på XML Schema. Det används bland annat i flera W3C rekommendationer.

Några länkar:
DTD - http://www.w3schools.com/dtd/
Xml Schema - http://www.w3.org/TR/xmlschema-0/
Relax NG - http://www.oasis-open.org/committees/relax-ng/tutorial.html

frågan var alltså ifall "beskrivning" == "xml schema" eller nåt annat.

Om det alltså är frågan om ett (eller flera schemas) så är det väl ganska självklart vad som ska finnas där, dvs vilka element/attribut får finnas var och deras datatyper. sen ifall det behöver finnas extension points får du fundera över och i så fall var dom ska finnas.

W3C Scheman är trots allt en accepterad industristandard t.ex. inom OASIS Universal Business Language, Dotnet, Biztalk, SOAP, osv, osv... Så det är svårt att inte rekommendera W3C Scheman! Skaffa ett bra vektyg typ typ Altova XML Spy så kan du till och med få den att skapa ett schema automatiskt från dina XML-dokument. Jag tror att Visual Studio har en enklare variant av samma sak. Du måste alltså inte lära dig W3C-Schema språket utantill för att bygga ett schema. Det skulle jag inte vilja rekommendera någon nybörjare att ge sig in på..

Jag förstår David Tellanders argument om man bara använder Notepad.exe
som utvecklingsverktyg, annars inte :)

Sen kan det hända att din uppdragsgivare hellre ville haft ett word-dokument, du kanske ska kolla upp det... :)