Archive for November, 2009

New Features in Captivate 4

November 25, 2009

As I mentioned in my earlier post on Captivate, I always enjoy using Captivate and admire its user-friendly features. Adobe has released Captivate 4 recently.

Here is the list of my favourite features:

  • Panning While Recording
  • Widgets
  • Project and Design Templates
  • Table of Contents
  • Single or Multiple SWF Output
  • Text-to-speech Captions
  • Captivate Reviewer
  • Photoshop Layer Support

To read a detailed review on Captivate 4, read Scott DeLoach’s article in

The most bothering drawback is Captivate 4 help system is not context-sensitive.


Technical Writer’s Role in UI Design

November 20, 2009


User Interface (UI) designing is no longer been a developers cup of tea nowadays. In most cases, it is the Technical Writer who becomes the first person to explore an application/product. As a result, a TW will be in a better person to tell his UI experience with the application/product in user point of view.

Being an individual contributor in my company, besides technical authoring, I almost wear multiple hats:

  • UI Design Advisor
  • Beta Tester
  • Product Trainer for the Beginners/Fresher.

Recently, I happen to test one application. Surprisingly, I was not a part of the team in the UI designing phase. An UI designer inside me came out while testing that application. Besides functionality testing, I started listing down UI design suggestions (Please note that they are only suggestions not advice). Look out the below image which bothered me a lot.

Bad UI Design

What is the necessity of placing a Close button below the Close icon already available by default..?

To be honest, for me it doesn’t makes any sense. Any UI should be designed keeping the User in mind no matter he is an advance or novice user. UI design should be in such a way that it should guide the user to explore the product without making him to press F1 often. You need not to design a colourful UI but definitely not a clumsy something like this:

Complex UI Design

      (Picture courtesy: Tom Johnson’s

Things to do before using the Captivate

November 18, 2009

 I always rely on Adobe Captivate (before it was Macromedia Captivate) for preparing training materials, tutorials and demos. It is simple to handle as well as effective in covering your clients training needs. Not only you can customize the call-outs and standard messages, but also it gives a real effect of exploring your product/application.

There are few pre-requisites before you start on with captivate.

Close your Outlook and Instant messenger services without any second thought. Whenever you get a new email, outlook will show a pop-pop alert. Captivate will capture those pop-ups also along with your regular actions in the application. So as a result, your client will come to know that your mailbox has exceeded its limit through your training demo.

Captivate captures your Outlook pop-ups

Never open or explore any applications, folders when you are capturing with the Captivate. Reason is same as mentioned above. Otherwise be ready to redo your capture.  🙂

Working with Bookmarks in Adobe PDFs

November 11, 2009

 Recently, the same friend raised one interesting query. It looked very simple. Here we go:

I have included chapter names, heading level 1, level 2 and so on as book marks in a FrameMaker book and generated a PDF. When I open that PDF for the first time, I would like to see only chapter names as bookmarks not all the heading levels expanded. Should I do something with FrameMaker settings..? This was her query.  


Only Chapters

Only Chapters as Bookmark


Chapters Expanded

chapters Expanded

As per my knowledge, FrameMaker has nothing to do with this query, it’s the Acrobat Professional that you need to do with some settings change while opening the PDF.  (As I don’t have a copy of Adobe professional, I was not able to mention the exact menu to change the settings.)

Later she got the exact answer from posted by Mr. Wayne. Here is the exact saying:

“If you “Open” the document in Adobe Professional – and you are using Adobe 6.0 or higher. You might look under the preferences screen and see if there might be a setting that says something like – “remember last” and check or uncheck the box depending on how the text is worded.

You might also just try opening the document in Adobe Professional – and then “collapse” all the bookmarks then save the document and reopen it and see if the bookmarks stay collapsed.

Try the following: Open Distiller and then select Settings > Security and then make sure the following box is UNCHECKED – “NO CHANGING THE DOCUMENT.”

So the exact solution is:

  1. Open the PDF in Adobe Professional and select Preferences
  2. Select “’remember setting of last view” option.
  3. Collapse all the bookmarks as you need.
  4. Save the PDF and close the Adobe Professional application.
  5. Open the same PDF again in the Adobe Professional.

You will find the bookmarks in same state as you needed.

It sounds so simple. Is it not..?  🙂

Documentation – Still a least cared area…?

November 9, 2009


I am a frequent visitor of Tom’s space. Last week when I was reading his post on wiki, few thoughts provoked me to update my space too. There is a unanimous belief among TWs’ is that Documentation is the least cared area and hardly very few project managers concern about the documentation while releasing a product. More or less it’s a fact too.

Though TWs’ took active participation in requirement analysis, UI designing, even QA testing, still documentation is considered as a grey area. I am really curious to know what will happen if any one ships their product without any documentation (includes both online and printed manuals)..? What will be the customer’s reaction on that product..?  It may sound funny or even weird, but I mean it.

Jeff has given a reply on my above comment at Tom’s space as follows:

I just read about a product that shipped without documentation – it’s called Fitbit, and in multiple reviews the reviewers complained that they couldn’t figure out how to use it and that there was no documentation.

See   for example.

Excerpt: “…shame that wasn’t in the manual. That’s because no manual comes with the thing, the implication being you just throw it on and go to town. Again that’s not quite the reality, especially when it comes to sleep.”

Thanks for this link Jeff.

On the other side of a coin, rarely we give feedbacks in our daily life. In any websites or help sections, there is a separate comment section for customer feedback.

Do we really like to drop a line over there..?

To be honest, I admit that I hardly give feedback. So, even I am not doing any justice to documentation, how could I expect a fair justice from others..? Hope I will change gradually.

%d bloggers like this: