Re: naming methods in manuals

Subject: Re: naming methods in manuals
From: David Castro <thetechwriter -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 27 Mar 2001 09:32:35 -0800 (PST)

> I'm leaning toward using the long name the first
> time the name appears in each HTML file and the shorter name for the other
> instances in each file. Does the fact that the manual will appear online
> (and won't necessarily be read linearly) affect whether we use the long or
> short name?

I read the responses you received yesterday for your post. The one thing I
didn't see mentioned was search engines. If a user searches using the long
term, then every topic that deals with that term should pop up. By using the
long term the first time in each HTML, you would assure that the topics would
show up when full-text searching on the long term.

-David Castro
email -at- davidcastro -dot- com
http://www.davidcastro.com


__________________________________________________
Do You Yahoo!?
Get email at your own domain with Yahoo! Mail.
http://personal.mail.yahoo.com/?.refer=text

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

*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available 4/30/01 at http://www.devahelp.com or info -at- devahelp -dot- com

A landmark hotel, one of America's most beautiful cities, and
three and a half days of immersion in the state of the art:
IPCC 01, Oct. 24-27 in Santa Fe. http://ieeepcs.org/2001/

---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Previous by Author: RE: Insurance for TW
Next by Author: Re: Multiple versions of a document (another JSP tangent from me)
Previous by Thread: RE: naming methods in manuals
Next by Thread: naming methods in manuals


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


Sponsored Ads