[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: New XML article
In message <199705232306.BAA13916@t...> Ingo Macherius writes: Thanks, [...] > > Just a note: > I went through the writer/editor/writer cycle 8 times for this article. The > main problem was the XML terminology. Formally correct sentences are often > not understandable by non-expert readers, while understandable versions are > often formally incorrect. So the cycle often was me writing formally correct I think this is extremely important. I have been (trying) to interpret and implement the XML-LINK spec and getting some of it wrong :-). XML is difficult in places unless you are quite familiar with SGML - I think XML-LINK will be a major challenge to the drafters. (I'm sure they'll manage it :-). This is why I'm keen about diagrams. XML-link is described in words, and it's incredibly easy to read the wrong meaning into them. For example, the 'locators' in 'links' locate 'resources' and it's not easy to write programs until it's absolutely clear what each of these means. The reverse is also true - when something is described clearly and precisely it makes it enormously easier to write code. > words, my editor "improving" them, me making the sentence correct again etc. > XML/SGML language could turn out to be a major problem for XML. E.g. just > try to explain the differences between markup/element/tag to a HTML person. > In HTML it's all the same ... (at least in common understanding). I agree. There are several aspects. One to protect the newcomer from too much terminology to start with. Of course it must always be precise. Another is to relate abstract terminology to concrete examples where possible. I have developed an XML application to manage terminology and I'm just about to start collecting XML terminology for it (unless someone is already doing this. It's loosely based on ISO12620 and displays a (hierarchical) glossary as an XML tree. P. -- Peter Murray-Rust, domestic net connection Virtual School of Molecular Sciences http://www.vsms.nottingham.ac.uk/ xml-dev: A list for W3C XML Developers Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ To unsubscribe, send to majordomo@i... the following message; unsubscribe xml-dev List coordinator, Henry Rzepa (rzepa@i...)
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|