× The internal search function is temporarily non-functional. The current search engine is no longer viable and we are researching alternatives.
As a stop gap measure, we are using Google's custom search engine service.
If you know of an easy to use, open source, search engine ... please contact support@midrange.com.


  • Subject: Trends in documentation delivery?
  • From: David Gibbs <david.gibbs@xxxxxxx>
  • Date: Wed, 16 Dec 1998 11:55:35 -0600
  • Organization: Mortice Kern Systems US, Inc.

Folks:

A techwriter in my office just asked me a question about trends in
documentation delivery...

We understand that a lot of documentation is being deliveried as
softcopy (HTML, PDF, Bookmanager, etc)... but we're interested in
standards for HARDCOPY documentation (huh?  What's that?)

Does anyone know what style guidelines IBM follows for hardcopy
documentation?  For example, fonts for keys a user types, information a
user types (on a command line or parameter line) and so on.  What is the
style usage for bolding, italicizing, quotation marks?  What style is
used when referencing a field name or menu option in text?

Also, it's been so long since I've actually installed a new machine,
what documentation does IBM actually deliver with a new system?  What's
the current format of the softcopy documentation delivered?  Bookmanager
still?

Thanks very much!

david (with Kathy looking over his shoulder)

--

David Gibbs
Sr. Software Engineer
Mortice Kern Systems US, Inc.
900 Oakmont Lane, Suite 400
Westmont, IL  60559
DID: (630) 734-5451
http://www.mks.com
work mailto:david.gibbs@xxxxxxxx
home mailto:david@xxxxxxxx.xxx

Opinions expressed are strictly my own and do
not necessarily reflect those of my employer

 "I drank what???"
  - Socrates


As an Amazon Associate we earn from qualifying purchases.

This thread ...

Follow-Ups:

Follow On AppleNews
Return to Archive home page | Return to MIDRANGE.COM home page

This mailing list archive is Copyright 1997-2024 by midrange.com and David Gibbs as a compilation work. Use of the archive is restricted to research of a business or technical nature. Any other uses are prohibited. Full details are available on our policy page. If you have questions about this, please contact [javascript protected email address].

Operating expenses for this site are earned using the Amazon Associate program and Google Adsense.