Lists Home |
Date Index |
- From: Peter Murray-Rust <firstname.lastname@example.org>
- To: John Cowan <email@example.com>,XML Dev <firstname.lastname@example.org>
- Date: Thu, 04 Jun 1998 00:37:43
At 14:31 03/06/98 -0400, John Cowan wrote:
>> John> Now that is an excellent idea! However, it would be necessary
>> John> to permit arbitrary XML markup within the doco, so a content
>> John> model of ANY is probably the right thing here.
>> I'd like to agree at least some conventions here, but I think we
>> should defer the details until later. For the moment, I think we
>> should concentrate on *where* we can put documentation.
>Agreed. I'll think about it.
>> With IDREF, we could keep the documentation separated from the schema, but
>> I'm a follower of the theory which says that the closer the documentation
>> is to the code, the more likely they are to correspond.
>I think that's best also.
This is critical, I think, for ease of authoring, readability, maintenance
and building programs. If we achieve nothing else, the formal linking of
documentation to XSchema/DTD components will be invaluable.
Peter Murray-Rust, Director Virtual School of Molecular Sciences, domestic
VSMS http://www.nottingham.ac.uk/vsms, Virtual Hyperglossary
xml-dev: A list for W3C XML Developers. To post, mailto:email@example.com
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:firstname.lastname@example.org the following message;
To subscribe to the digests, mailto:email@example.com the following message;
List coordinator, Henry Rzepa (mailto:firstname.lastname@example.org)