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.
Subject:RE: Proving an MS standard From:"Brierley, Sean" <Sean -at- Quodata -dot- Com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 15 Feb 2001 10:19:59 -0500
I misunderstood, too. I thought the lack of a TOC or index was being
attributed to the use of HTML. You can have these things with HTML.
> -----Original Message-----
> From: Scott Turner [SMTP:sturner -at- airmail -dot- net]
> >At 1:38 PM -0800 2/14/2001, Scott Turner wrote:
> >>The real problem is that there is no table of contents, there is no
> >>index. You cannot effectively search the book. A real reason not to
> >>use HTML for online documentation.
> >What relationship are you trying to draw between "lacks a TOC or index"
> >"presented in HTML"? Surely you're not suggesting either that a printed
> >PDF book could not lack these necessary features, or that a set of HTML
> >documents could not have them?
> My point is that the site does not have them. I was informed that
> with Microsoft IE you can search a library.
> My POINT is that the requirement of a specific browser,
or Applets that work with all browsers. If you refer to Microsoft's
proprietary HTML Help format, your thinking is off. MS HTML Help is a
compiled format and has the extension CHM. This is a replacement for
WinHelp, HLP. WinHelp was proprietary. WinHelp only worked in Windows. And,
WinHelp used a specific viewer, just as CHMs use a specific viewer: I.E.
> the lack of
> cross-references in the current offering is exactly what I said, less
> than effective. The offering that Microsoft has given on thier site
> it technically correct but not useful unless you use thier product,
> and/or are willing to sit and scan file after file for information.
So why not use their product if it helps you get what you need?
> Isn't that what is commonly lambasted on this list? The lack of
> precise and helpful organization and format?
It depends . . . I would suggest that MS concluded their audience was
Microsoft users likely to be using Microsoft tools and therefore targeted
that audience. If they missed with you, that is their bad, yes.
> Microsoft did not spend enough effort to ensure that the information,
> in the format that they provided, was useful and easy to extract
> I have monitored this list long enough to know that when technical
> writers encounter this sort of shoddy work, they are very vocal
> revealing it. Am I to be corrected or brought to task simply because
> the owner of the information is Microsoft?
> I beg to differ.
I read that you wrote this:
>>The real problem is that there is no table of contents, there is
>>index. You cannot effectively search the book. A real reason not
>>use HTML for online documentation.
To me, and others, that seemed to indicate you were linking a lack of a TOC
and index to the HTML format. This conclusion has nothing to do with
Microsoft or your disdain for Microsoft.
sean -at- quodata -dot- com
Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Sponsored by ForeFront, Inc., maker of ForeHelp Help authoring tools
for print, WinHelp, HTML Help, JavaHelp, and cross-platform InterHelp
See www.forehelp.com for more information and free evaluation downloads
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.