[
Lists Home |
Date Index |
Thread Index
]
- From: Peter Murray-Rust <peter@ursus.demon.co.uk>
- To: John Cowan <cowan@locke.ccil.org>,XML Dev <xml-dev@ic.ac.uk>
- 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.
P.
Peter Murray-Rust, Director Virtual School of Molecular Sciences, domestic
net connection
VSMS http://www.nottingham.ac.uk/vsms, Virtual Hyperglossary
http://www.venus.co.uk/vhg
xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@ic.ac.uk
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:majordomo@ic.ac.uk the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@ic.ac.uk)
|