Re: Assume web-server knowledge?

Subject: Re: Assume web-server knowledge?
Date: Wed, 4 Jun 2014 09:23:13 -0700

There has to be a minimum knowledge requirement if a web server is
involved. Most of these requirements depend a lot on the technologies used
to serve pages.

If the files are merely HTML without JavaScript, then they can run off a
file share, and a server isn't necessary. So a command to copy the files to
a common location and give everyone access to that location should suffice.
It wouldn't matter if people use http:// or file:/// because in this case
both would work.

However, if JavaScript is used, and the client work site uses IE, then the
Scripts will be blocked when loaded locally, so a web server is
required. Also, if specific web server features are required to generate
content from scripts or include common content, then you would want to make
sure the server is capable of running those features.

In both cases, you should state the required features needed by the web
server which hosts the documentation. This would politely invite the user
to evaluate their level of expertise by describing technology that should
be familiar. Otherwise they will seek out someone with the necessary skills.

Roundabout way to answer an open ended question.


On Wednesday, June 4, 2014, McLauchlan, Kevin <

> My question is when serving from a webserver is contemplated, should we
> have any more instruction in the README than "Copy the contents of the
> documentation DVD to the web server"?
> Should we just assume that anyone doing it knows where it should go, where
> the top index file would need to go, whether or where any web.config file
> might go, etc.?


Learn more:



To unsubscribe send a blank email to




Assume web-server knowledge?: From: McLauchlan, Kevin

Previous by Author: TechWhirl: Technical Communication Recap for June 27, 2014
Next by Author: Re: Surface and Tech Writing
Previous by Thread: Assume web-server knowledge?
Next by Thread: Word 2013: Para markers on ruler not visible

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

Sponsored Ads