User Experience Stack Exchange is a question and answer site for user experience researchers and experts. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

I'm getting ready to release an app onto the Mac Appstore and am in need of some advice. The app is really very simple but I'm thinking about adding a quick tutorial.

Would I be better off creating an Apple Help book so that when the user clicks the help menu item the Apple help interface appears?

Or should I create a tutorial inside of my application that the user can navigate through?

Any thoughts would be greatly appreciated.

I should add that I actually already have everything in place for an "in app" tutorial, so the Help Book would actually take more work. I'm just trying to do what's best for the user.

share|improve this question

migrated from Aug 27 '11 at 23:59

This question came from our site for professional and enthusiast programmers.

This is quite subjective.... – esqew Aug 27 '11 at 23:53
Whatever you do, make sure that when the user accesses the Help menu they don't just get a dialog saying Help isn't available for XYZ... – Rob Keniger Aug 27 '11 at 23:57
@Rob Good point! I went ahead and created an "in app" tutorial but I set the "Help" menu item to open my apps in app tutorial as well. That way the user doesn't get an error, instead they actually get help. Thanks for the tip. – Sam Aug 28 '11 at 3:43

Sounds like you already have a good plan (in-app help with the menu bar linking to it), but I'll throw in one more idea. Since you're using the Mac App Store, and everyone looks at the screenshots, you could put some simple tips on top of the images. Like what iA Writer does for their iPad app:

share|improve this answer

The helpbook window is somewhat annoying.. I think it's because it's not running as a separate app, ALT-TAB is not working, making it difficult to switch between the help and the app. I much prefer being able to ALT-TAB between help and the app.

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.