Paul,

You wrote:

The PDF "e-book" that comes with Microsoft Manual of Style, 3rd
edition, is this month's guest at the Hmmm... corner at microtype.com.
Authored with FrameMaker 7.0, this PDF has a total of ... one link
(which happens to be a bad link), see
http://www.microtype.com/Hmmm.html

You certainly have a point there, Shlomo, but the PDF version is a
godsend to Mac and UNIX users. In fact, I'm out of the office traveling
in Japan right now and was able to look something up about check boxes
thanks to the PDF.

Personally, I've always preferred Apple's Publications Style Guide but
follow the MS way if I believe the consistency will help users.

Apple updated its guide in January.
<http://developer.apple.com/documentation/UserExperience/Conceptual/
APStyleGuide/AppleStyleGuide2006.pdf>

Incidentally, my mate Bruce insists that "Microsoft Manual of Style" is
an oxymoron ;-)

I don't have a problem with using a cross-platform PDF as opposed to a Windows-specific CHM (available previously for the Microsoft Manual of Style). And I definitely prefer having a "zero-links PDF" than not having one at all.

I strongly disagree with the approach that effectively says "we'll just save the manual as PDF and thus we'll have an e-book ready for shipping... linking is nice to have, but perhaps in a future version".

I had a brief look in the updated Apple style guide. From the linking point of view, it is in the same class as the Microsoft guide. What could be more basic in such an "e-book" reference than to have the entries following "See" and "See slso" properly linked to the target (rather than force you to locate that target yourself)?

Unfortunately, the "standard" set by the PDFs offered from many major companies [Adobe included; several entries in the Hmmm corner point to several PDFs provided with FM/Acrobat products] propagates in all directions: "if this is good enough for <<name>>, then why couldn't it be good enough for us"?


Shlomo Perets

MicroType, http://www.microtype.com
Training, consulting & add-ons: FrameMaker, Structured FM and Acrobat




_______________________________________________


You are currently subscribed to Framers as [EMAIL PROTECTED]

Send list messages to [EMAIL PROTECTED]

To unsubscribe send a blank email to [EMAIL PROTECTED]
or visit 
http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com

Send administrative questions to [EMAIL PROTECTED] Visit
http://www.frameusers.com/ for more resources and info.

Reply via email to