Re: Noting Directories

Subject: Re: Noting Directories
From: Kris Olberg <kjolberg -at- IX -dot- NETCOM -dot- COM>
Date: Fri, 17 Oct 1997 11:53:21 -0500

> From: Melonie Holliman <mrh -at- abmdata -dot- com>
> I am creating a manual which eventually will cover both an NT
> and a UNIX version of our server product. My boss does not
> want me to be platform specific when I note directories. Does
> anyone have an elegant solution to this? Since I cannot use
> slashes I have been writing it like this:

Why can't you use slashes? It's the clearest, most common way to denote a
directory hierarchy.

I'd use forward (/) slashes. If your audience needs some help interpreting
these, especially the NT users, supply that prominently in a few places as
a reminder (in the margin, as a footnote ...) in addition to putting it in
a Conventions section.

kolberg -at- actamed -dot- com
kris -at- olberg -dot- com

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
Search the archives at or search and
browse the archives at

Previous by Author: Re: Programs new tech writers should know
Next by Author: Re: document ownership/plagiarism (kind of long)
Previous by Thread: Noting Directories
Next by Thread: Pricing Question

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

Sponsored Ads

Sponsored Ads