TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
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