[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Documenting XSLT (Was: Note from the Troll)

• To: AndrewWatt2000@a...
• Subject: Re: Documenting XSLT (Was: Note from the Troll)
• From: "J.Pietschmann" <j3322ptm@y...>
• Date: Mon, 28 Oct 2002 22:19:13 +0100
• Cc: gkholman@C..., xml-dev@l...
• References: <1c3.bd6162.2aeefee6@a...>
• User-agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.1) Gecko/20020826

AndrewWatt2000@a... wrote:
> If you were designing XSLT 1.0 from scratch wouldn't you add a 
> documentation element which can be used widely throughout the document 
> (or modules) in the way the the SVG 1.0 <desc> and the XSD Schema 
> <documentation> element can be used? And, specifically, wouldn't you 
> design that XSLT documentation element so it can be nested inside templates?

Why should every spec invent it's own documentation format
while there is HTML and all the stuff? Its like reinventing the
wheel. I think it is much more flexible to say "at this point,
put whatever you want unless it conflicts with the rest", so that
people can put their doc in there in XHTML, n-walsh-doc, SVG or
whatever.
You know, there are people who want to put links and images into
their docs, and whatnot.
Of course, a <document> element would be of some use if it
encapsulated foreign XML, so that it can be placed anywhere.

J.Pietschmann

• References:
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: AndrewWatt2000@a...

• Prev by Date: RE: Documenting XSLT (Was: Note from the Troll)
• Next by Date: Re: Do We Need James Clark to get Good Recs?
• Previous by thread: Re: Documenting XSLT (Was: Note from the Troll)
• Next by thread: Re: Documenting XSLT (Was: Note from the Troll)
• Index(es):
  • Date
  • Thread