Re: XML tag usage question

Subject: Re: XML tag usage question
From: Michele Davis <michele -at- krautgrrl -dot- com>
To: Tech Whirlers <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 04 Apr 2006 14:47:58 -0500

Sarah,

My personal opinion would be to put the disclaimer in, that saves you a lot of time and you probably have a lot of other work to do than changing a bazillion documents. If you have nothing to do but that task I'd say go change every single document. Might drive ya a little buggy though.

Michele

---------------
Michele E. Davis, Writer
Kraut Companies
www.krautgrrl.com
www.krautboy.com
and the uber geek empyre




siliconwriter -at- comcast -dot- net wrote:

In defining an XML tag, you usually use the word "attribute" to describe a defined field within an element. My guy is using the word "prop", short for property. I believe that readers familiar with XML (which will be many of them) might be confused by our renaming of a familiar term. However, if I change "prop" to "attribute" throughout the paper, I must do so in every other paper written by the software department, and that's a lot of papers.
Should I change the word "prop" to "attribute" throughout the documents, or should I go ahead and accept this unfamiliar usage, possibly with a "disclaimer" or "definition" at the start of each chapter? The first benefits my readers, the second my client. Any thoughts?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.


References:
XML tag usage question: From: siliconwriter

Previous by Author: Being on techwhirler
Next by Author: Re: It's PIZZA FRIDAY!!
Previous by Thread: XML tag usage question
Next by Thread: Re: XML tag usage question


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


Sponsored Ads