TweetFollow Us on Twitter

Guide Book Reviews
Volume Number:12
Issue Number:1
Column Tag:Book Review

New Apple Guide Authoring Aids

Three books and accompanying software for Apple Guide authoring

By John R Powers, III, guideWorks, LLC

Apple Guide Complete: Designing and Developing Onscreen Assistance
By Apple Computer, Inc.
Addison-Wesley (0-201-48334-3)

$39.95. 554 pages.

Real World Apple Guide
By Jesse Feiler
M&T Books (1-55851-429-5)
$39.95. 411 pages.

Danny Goodman’s Apple Guide
Starter Kit
By Danny Goodman and
Jeremy Joan Hewes
Addison-Wesley (0-201-48349-1)

$34.95. 295 pages.

Apple Guide authoring just got a lot easier. Three new books and accompanying software make it that way. If you already know about Apple Guide, skip to the next section. Otherwise, hang on and I’ll give you a quick introduction. [For more on Apple Guide, see the March and July ’95 MacTech Magazine.]

Introducing Apple Guide

Apple Guide is the exciting help system that comes with System 7.5. It enables users to accomplish tasks with minimal directions. It actively leads users through the steps required to complete desired tasks. For example, let’s pretend you make fax software. You may use Apple Guide to lead your user through the steps to send a fax, including how to set up the address, cover page, and scheduling transmission. You do this by creating a guide file that interacts with the user step-by-step. The guide file checks the user’s context and presents only the necessary information. It also automates many of the steps via AppleScript, and uses Apple Guide’s unique “coach marks” to highlight live interface elements so that users can simply point-and-click their way through the process. Your users are happier and your customer support line is less busy.

With the recent release of version 2.0, Apple Guide technology is available from System 7.0 on up; and it will be a key part of Active Assistance in Copland. More and more applications are including guide files. Third party developers like the way it gives them a competitive advantage and reduces the load on customer support. Major corporate users like how it streamlines the work flow and how it reduces the load on the help desk.

Authoring Apple Guide

One authors Apple Guide by combining content and instructions into a guide file. The current guide authoring tools are Guide Maker, Guide Composer, and Danny Goodman’s Apple Guide Starter Kit.

Guide Maker is the original Apple Guide authoring tool developed by Apple. It’s five tools in one: build guide files, test look-for, diagnose guides, convert WinHelp, and import/export for localization. Guide Maker uses Guide Script as its means for “programming” guide files. Guide Script is a mark-up language; the author writes the guide content and tags the content with Guide Script. There are about 100 commands that control startup parameters, formats, sorting, sequences, and much more.

Guide Composer and Danny Goodman’s Apple Guide Starter Kit (the latter included with his book, discussed in this article) are two new tools that provide a WYSIWYG interface to guide authoring. Both of them output Guide Script for automatic compilation by Guide Maker Lite, a special version of Guide Maker without a user interface.

New Authoring Aids

The new books and accompanying software are:

Apple Guide Complete: Designing and Developing Onscreen Assistance

This is Apple’s own Apple Guide book, written by Apple’s Developer Press. Think of it as the Apple Guide Inside Mac, 2nd Edition, for guide authors. It provides authoring tips and suggestions, describes how to use Guide Maker and Guide Script, and documents the Apple Guide API.

Apple Guide Complete includes a CD-ROM with lots of Apple Guide material, including Apple Guide, Guide Maker, sample guide files, sample source files, sample context checks, the Apple Guide interface files and libraries, and a searchable command reference to all Guide Script commands. The CD-ROM does not contain the latest release of Apple Guide (2.0), Guide Maker (1.2.7), or Guide Maker Lite (1.2.5); those you’ll have to get from Apple’s ftp site, Apple’s Developer CD, or the Mac OS SDK.

Real World Apple Guide

This book covers much of the same material as in Apple Guide Complete, but with an emphasis on actually using Apple Guide to solve problems. Think of it as Jesse’s Handy Guide to Using Apple Guide. It contains the prerequisite chapters on Apple Guide, Guide Maker, Guide Script, and the API, but also includes chapters on creating guide files for use with common frameworks and applications. For example, it describes how to add Apple Guide to MacApp and 4th Dimension.

An accompanying CD-ROM includes Apple Guide, Guide Maker, and related files. It also includes lots of demos, and a cookbook which comprises shells, guide script examples, and code examples. Like Apple Guide Complete, the CD-ROM does not contain the latest releases.

Danny Goodman’s Apple Guide Starter Kit

This book takes a completely different approach from the other two. Danny starts the reader immediately authoring guide files using his Starter Kit software. It’s a very “hands on” approach that quickly produces a guide file from Danny’s WYSIWYG interface. Once you learn how to use the authoring tool, Danny and his co-author, Jeremy Hewes, introduce design concepts and advanced topics.

The book includes a floppy disk with the Guide Starter software, Guide Maker Lite, a sample application, and support files. Apple Guide and Guide Maker are not included, nor are they necessary since Apple Guide is in System 7.5 and Guide Maker Lite is the only compiler Danny’s software needs.

Comparisons

We’ll attempt to help you sort out the possibilities by providing a couple of different ways to compare the books.

Who is the reader?

Third party developers use Apple Guide create guides for their applications. All three books cover this.

Solution providers use Apple Guide to develop custom guides for end users. While ways to do this can be inferred from any of the three books, only Real World Apple Guide includes specific information on creating guides for common third party applications and frameworks.

Application software engineers need information on how to support Apple Guide within their applications. Apple Guide Complete and Real World Apple Guide provide API documentation for this.

How well do they support the development process?

Creating Apple Guide files requires a seven-step process: task analysis, instructional and visual design, writing content, scripting, application integration, testing, and localization. Let’s examine how each book supports each step in the development process.

Task analysis: identifying and articulating the tasks that the user must accomplish. This is a very difficult step, but essential for Apple Guide’s task-oriented design. Conclusion: zip for all three. None of the books provide help in this essential area.

Instructional and visual design: specifying how the guide will support the user’s tasks. Conclusion: all three books provide good coverage of this area. Apple Guide Complete provides the most information on design.

Writing content: creating the words and images to support the instructional and visual design. Also includes all the indexing of the guide topics for the Apple Guide’s search engine. Conclusion: Apple Guide Complete and Danny Goodman’s book provide information on this area. Apple Guide Complete also covers the difficult area of indexing.

Scripting: wrapping the Guide Script around the content. This includes all the sequencing of steps, context checking, and automation. Conclusion: All three books provide ample coverage of this difficult step in the process. None of the books cover automation scripting using AppleScript, though.

Application integration: Apple Guide does not require that the application it supports be changed in any way, but if you can change it, you can really improve the user interaction. Application integration adds code to the application to support the guide. Conclusion: Apple Guide Complete and Real World Apple Guide provide reference material for application integration. Real World Apple Guide also provides detailed integration information for MacApp.

Testing: guide files must be tested like any other complex software. Conclusion: Apple Guide Complete provides a little information.

Localization: guide files, like the applications they support, must serve an international market. The guide content must be localized. Conclusion: Apple Guide Complete provides a little information.

What do I buy?

All three books are helpful for guide authoring. If you have to pick just one, consider the following: For a comprehensive reference, pick Apple Guide Complete. For custom solutions and practical applications, pick Real World Apple Guide. For a fast start, pick Danny Goodman’s Apple Guide Starter Kit.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

djay Pro 1.1 - Transform your Mac into a...
djay Pro provides a complete toolkit for performing DJs. Its unique modern interface is built around a sophisticated integration with iTunes and Spotify, giving you instant access to millions of... Read more
Vivaldi 1.0.118.19 - Lightweight browser...
Vivaldi browser. In 1994, two programmers started working on a web browser. Our idea was to make a really fast browser, capable of running on limited hardware, keeping in mind that users are... Read more
Stacks 2.6.11 - New way to create pages...
Stacks is a new way to create pages in RapidWeaver. It's a plugin designed to combine drag-and-drop simplicity with the power of fluid layout. Features: Fluid Layout: Stacks lets you build pages... Read more
xScope 4.1.3 - Onscreen graphic measurem...
xScope is powerful set of tools that are ideal for measuring, inspecting, and testing on-screen graphics and layouts. Its tools float above your desktop windows and can be accessed via a toolbar,... Read more
Cyberduck 4.7 - FTP and SFTP browser. (F...
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Labels & Addresses 1.7 - Powerful la...
Labels & Addresses is a home and office tool for printing all sorts of labels, envelopes, inventory labels, and price tags. Merge-printing capability makes the program a great tool for holiday... Read more
teleport 1.2.1 - Use one mouse/keyboard...
teleport is a simple utility to let you use one single mouse and keyboard to control several of your Macs. Simply reach the edge of your screen, and your mouse teleports to your other Mac! The... Read more
Apple iMovie 10.0.8 - Edit personal vide...
With an all-new design, Apple iMovie lets you enjoy your videos like never before. Browse your clips more easily, instantly share your favorite moments, and create beautiful HD movies and Hollywood-... Read more
Box Sync 4.0.6233 - Online synchronizati...
Box Sync gives you a hard-drive in the Cloud for online storage. Note: You must first sign up to use Box. What if the files you need are on your laptop -- but you're on the road with your iPhone? No... Read more
Fantastical 2.0.3 - Create calendar even...
Fantastical 2 is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event... Read more

SoundHound + LiveLyrics is Making its De...
SoundHound Inc. has announced that SoundHound + LiveLyrics, will be one of the first third-party apps to hit the Apple Watch. With  SoundHound you'll be able to tap on your watch and have the app recognize the music you are listening to, then have... | Read more »
Adobe Joins the Apple Watch Lineup With...
A whole tidal wave of apps are headed for the Apple Watch, and Adobe has joined in with 3 new ways to enhance your creativity and collaborate with others. The watch apps pair with iPad/iPhone apps to give you total control over your Adobe projects... | Read more »
Z Steel Soldiers, Sequel to Kavcom'...
Kavcom has released Z Steel Soldiers, which continues the story of the comedic RTS originally created by the Bitmap Brothers. [Read more] | Read more »
Seene Lets You Create 3D Images With You...
Seene, by Obvious Engineering, is a 3D capture app that's meant to allow you to create visually stunning 3D images with a tap of your finger, and then share them as a 3D photo, video or gif. [Read more] | Read more »
Lost Within - Tips, Tricks, and Strategi...
Have you just downloaded Lost Within and are you in need of a guiding hand? While it’s not the toughest of games out there you might still want some helpful tips to get you started. [Read more] | Read more »
Entertain Your Pet With Your Watch With...
The Petcube Camera is a device that lets you use live video to check in on your pet, talk to them, and play with them using a laser pointer - all while you're away. And the Petcube app is coming to the Apple Watch, so you'll be able to hang out with... | Read more »
Now You Can Manage Your Line2 Calls With...
You'll be able to get your Line2 cloud phone service on the Apple Watch very soon. The watch app can send and receive messages using hands-free voice dictation, or by selecting from a list of provided responses. [Read more] | Read more »
R.B.I. Baseball 15 (Games)
R.B.I. Baseball 15 1.01 Device: iOS Universal Category: Games Price: $4.99, Version: 1.01 (iTunes) Description: The legendary Major League Baseball franchise returns to the diamond. Make History. ** ALL iPOD Touch, the iPad 2 and the... | Read more »
Here's How You Can Tell if an App W...
The Apple Watch is pretty much here, and that means a whole lot of compatible apps and games are going to be updated or released onto the App Store. That's okay though, beacause Apple has quietly updated their app description pages to make things... | Read more »
Forgotten Memories : Alternate Realities...
Forgotten Memories : Alternate Realities 1.0.1 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0.1 (iTunes) Description: + REDUCED PRICE ONLY THE LAUNCHING WEEK + "The most exciting horror game of 2015." - AppSpy... | Read more »

Price Scanner via MacPrices.net

Intel Compute Stick: A New Mini-Computing For...
The Intel Compute Stick, a new pocket-sized computer based on a quad-core Intel Atom processor running Windows 8.1 with Bing, is available now through Intel Authorized Dealers across much of the... Read more
Heal to Launch First One-Touch House Call Doc...
Santa Monica, California based Heal, a pioneer in on-demand personal health care services — will offer the first one-touch, on-demand house call doctor app for the Apple Watch. Heal’s Watch app,... Read more
Mac Notebooks: Avoiding MagSafe Power Adapter...
Apple Support says proper usage, care, and maintenance of Your Mac notebook’s MagSafe power adapter can substantially increase the the adapter’s service life. Of course, MagSafe itself is an Apple... Read more
12″ Retina MacBook In Shootout With Air And P...
BareFeats’ rob-ART morgan has posted another comparison of the 12″ MacBook with other Mac laptops, noting that the general goodness of all Mac laptops can make which one to purchase a tough decision... Read more
FileMaker Go for iPad and iPhone: Over 1.5 Mi...
FileMaker has announced that its FileMaker Go for iPad and iPhone app has surpassed 1.5 million downloads from the iTunes App Store. The milestone confirms the continued popularity of the FileMaker... Read more
Sale! 13-inch 2.7GHz Retina MacBook Pro for $...
 Best Buy has the new 2015 13″ 2.7GHz/128GB Retina MacBook Pro on sale for $1099 – $200 off MSRP. Choose free shipping or free local store pickup (if available). Price for online orders only, in-... Read more
Minimalist MacBook Confirms Death of Steve Jo...
ReadWrite’s Adriana Lee has posted a eulogy for the “Digital Hub” concept Steve Jobs first proposed back in 2001, declaring the new 12-inch MacBook with its single, over-subscribed USB-C port to be... Read more
13-inch 2.7GHz Retina MacBook Pro for $1234 w...
Adorama has the 13″ 2.7GHz/128GB Retina MacBook Pro in stock for $1234.99 ($65 off MSRP) including free shipping plus a free LG external DVD/CD optical drive. Adorama charges sales tax in NY & NJ... Read more
13-inch 2.5GHz MacBook Pro available for $999...
 Adorama has the 13-inch 2.5GHz MacBook Pro on sale for $999 including free shipping plus NY & NJ sales tax only. Their price is $100 off MSRP. Read more
Save up to $600 with Apple refurbished Mac Pr...
The Apple Store is offering Apple Certified Refurbished Mac Pros for up to $600 off the cost of new models. An Apple one-year warranty is included with each Mac Pro, and shipping is free. The... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions (US) - A...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
Service-Learning Counselor, *APPLE* Corps -...
…CONTRACT TITLE Higher Education Assistant FLSA Exempt CAMPUS SPECIFIC INFORMATION APPLE Corps (Academic Preparation Program for Law Enforcement), a partnership between Read more
*Apple* iOS Specialist - Kforce (United Stat...
Our client is seeking an Apple iOS Specialist to join their team in Quincy, Massachusetts (MA). Duties: * Responsible for configuration and distribution of desktop, Read more
*Apple* Systems Engineer - Axius Technologie...
* Must be Apple -Certified specialist and will be responsible for all hardware: device settings, images creation/deployment, security implementation * Responsible for all Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.