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.
Sandra Charker is involved in setting up a mid-sized intranet site in support
of a very large IT project for a government department.
----------------------------------------------------------------------
Your programmer is a bone head. Now that that is out of the way, we can continue.
A few years ago I was involved in a similar project for the D.O.E. We used pdfs rather than HTML files because some of the material was also burnt to CDs for distribution to those without access to the intranet.
My suggestion is keep it simple -- KISS is still a valuable design principle.
If one of your docs is revised, keep the revised page names the same as the original. This way there will be less maintenance required on the index page(s) and links. Show revision number and date on the doc, if needed. If you need to keep the old version for historical purposes or whatever bureaucratic purposes that government managers dream up, move the old doc to a directory/folder named "superceeded docs", or words to that effect.
On your opening page, make to links "English" and "Espanol" or whatever language you are using. Make a separate directory tree for each language. They don't need to be linked to each other.
My curmudgeonly $0.02
John Gilger
Senior Technical Writer
Acres Gaming, Inc.
Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at http://www.ehelp.com/techwr-l
---
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.
