[Elecraft] K3 Manual Question

Bill W5WVO w5wvo at cybermesa.net
Wed Oct 10 19:53:24 EDT 2007


Craig, we're really not that far apart here.

> It's prohibitively expensive and adds significant complications for
> the manufacturer, who has to maintain revision information per-page.

Maintaining revision information for updated pages is trivial. Adobe 
FrameMaker makes this easy even without using XML tags. I won't bore everyone 
with inside-baseball details here, but believe me, it's a no-brainer, takes 
almost no time, and costs nothing extra. The tools are there. (No, not MS 
Word. Anybody who is still trying to use MS Word for large, evolving sets of 
complex technical documents either isn't really serious about technical 
documentation to begin with, or is, um, alarmingly underinformed.  :-)

> The solution of offering a downloadable PDF of the manual is simpler
> for the manufacturer . . . Users could print the manual if they
> wanted, but otherwise I wouldn't have killed as many trees, Al Gore
> would be happy, and we'd save $10/unit sold over distributing a
> seldom-read manual.

I agree! It does cost less not to publish paper manuals. As a tech writer for 
a major Silicon Valley semiconductor company, I put out thousands of pages of 
PDF documents a year that are never printed on paper. What I'm saying is not 
that manuals necessarily have to be printed on paper by the manufacturer, but 
rather that adopting a different documentation paradigm  (a) would cost no 
more than the current process, and  (b) might well be more attractive to many 
end users than the current process.

I'm suggesting that it makes sense to structure ham radio manuals more like 
military radio manuals, and adopt a similar upgrading scheme. Whether you do 
this on paper, on a CD-ROM, as downloadable files, or as a combination of all 
of these doesn't really matter. Documentation downloads from the website and 
CD-ROMs shipped with the radio would be free, but CD-ROMs ordered separately 
from the radio would be charged for, as would any paper documentation (whole 
manuals and updates) printed and shipped by the manufacturer. It could be 
preprinted and inventoried or, since it doesn't have to be bound, produced 
in-house as ordered. The saved cost of binding could be used to cover the 
additional cost of edge-reinforced punched stock, if desired.

Most end users who want a paper manual would choose the option of printing it 
themselves on ordinary printer paper. If the manuals and updates were designed 
as I described in my previous post, they would lend themselves exceptionally 
well to home printing and loose-leaf binding. The user wouldn't have to print 
out a whole new manual every time there's an update. Those who care to could 
keep their manuals up-to-date elegantly and with a minimum of fuss; those who 
don't care to would never be bothered.

Bill / W5WVO 



More information about the Elecraft mailing list