Re: XML tag usage question

Subject: Re: XML tag usage question
From: siliconwriter -at- comcast -dot- net
To: techwr-l -at- lists -dot- techwr-l -dot- com (Tech Whirlers)
Date: Tue, 04 Apr 2006 21:27:40 +0000

Eric, your Google argument may carry more weight with our programmer than the W3C. :)

The explanation I got was that the XML library our programmers are using uses the term "prop", short for property, when describing an element attribute. Furthermore, the software developers tell me that they have "already used the word 'attribute' to mean something else" in our proprietary software. This tells me that our programmers are less than fully conversant in XML, and that their XML library may be non-standard.

Resolution:
I went to the head of software development and 'splained things to him, and we agreed to replace the word 'prop' with 'attribute' throughout the documentation. Although this means work for me, I would rather do this than risk a user missing a one-line disclaimer telling him that in our world, "prop" means "attribute". :) I'll probably always have to do this, since the likelihood of our programmers deciding to use proper terminology is nil. However, our customers will be happier, and that's what counts.

Thanks for the feedback, all.

Sarah


-------------- Original message ----------------------
From: eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com

> Besides the recognised standards and every decent introduction, web site,
> and text book I know, Google fight gives 365,000 for "element attribute"
> vs. 83,900 for "element property".
>
> Eric L. Dunn
> Senior Technical Writer

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: XML tag usage question
Next by Author: Re: XML tag usage question
Previous by Thread: Re: XML tag usage question
Next by Thread: XML tag usage question


What this post helpful? Share it with friends and colleagues:


Sponsored Ads