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

Re: Integrity in the Hands of the Client

  • From: "Eve L. Maler" <elm@a...>
  • To: Peter Murray-Rust <peter@u...>, xml-dev@i...
  • Date: Mon, 24 Nov 1997 15:07:43 -0500

Re: Integrity in the Hands of the Client
At 12:04 PM 11/22/97 -0500, Nelson Minar wrote:
...
>I'm reminded of what happened in the first few months of 1994, when a
>lot of people suddenly learned HTML. One of the most useful documents
>(for me) of that period was Eric Tilton's essay "Composing Good HTML"
>(since turned into a book, "Web Weaving", with Carl Steadman and Tyler
>Jones). It was a short essay, but it laid out many of the basics of
>writing HTML well - issues beyond syntax. Style issues like "don't say
>'click here' in a document, integrate the anchor text into the
>narrative". Structural issues like "don't misuse headers" and "try to
>do logical formatting, not physical". And meta information
>recommendations, like "put your name on documents" and "put a last
>modified date on documents if it makes sense". For me, that essay made
>HTML made sense, gave some order to the varied capabilities of the syntax.
>
>I tried to do my bit back then by writing an HTML editor tool (an
>emacs mode) that made it easier to write good HTML. Indenting the HTML
>source to show the document structure, providing simple templates to
>get basic well formedness, automating last modified footers. And I
>think it was reasonably successful - pages written with my editor were
>at least a little better than pages written with nothing.
>
>
>XML needs similar style guidelines and tools if people are going to
>use it well. The problem for XML is harder than with HTML since XML is
>more powerful. I think XML will be most successful for casual document
>writers when there are standard well-established DTDs combined with
>style sheets that are simple to use and very well documented as to
>what the tags mean and how to use them. I don't know how to smooth the
>process of helping people develop their own DTDs.

I agree that XML needs similar guidelines; there's technology, and then
there are the techniques with which you apply it.  It's ideal if new users
can get started with good habits as soon as possible.

I would say the problem for XML is harder because XML is more "meta" (and
it derives its extra power from that).  Each DTD and DTD fragment will need
its own user/style guide -- many of the established DTDs already have user
guides, and for some there are even courses that teach you how to use them.

If I may, I'd like to suggest that budding XML DTD writers check out my
book, "Development SGML DTDs: From Text to Model to Markup" (ISBN
0-13-309881-8, published by Prentice Hall Professional Technical Reference
<http://www.prenhall.com/>).  It contains a system for doing the
requirements analysis for, designing, implementing, and testing DTDs, and
has a lot of technique advice in it (as well as some psychological advice
for dealing with the shock of migration :-).

Its focus is on publishing applications and corporate SGML use, but my
co-author, Jeanne El Andaloussi, and I have used the basic methodology to
create many DTDs for many different situations, and it seems to hold up
very well.  Also, the analysis and design phases can be completed with
little detailed knowledge of SGML/XML language syntax.

We wrote the book precisely to "smooth the process of helping people
develop their own DTDs" for SGML; I'm certainly hoping that new XML users
will find it helpful too.

Best regards,

	Eve

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i...
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:majordomo@i... the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@i... the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@i...)


PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.