Improving the Online Help

Hi, Ana, it's great to have you on the Astaro team!  Your task is one that has had a back seat for too long at Astaro.

The fundamental problem with the Help is that it does nothing more than open the users' manual and jump to the relevant page.  While that's better than nothing, it's not much better, so the good news is that you can make some incredible progress fairly easily.

If you increase the utility of the on-line manual, you kill two birds with one stone.

• Add a 'Search the Users' Manual' box to the interface to allow pop-up, indexed searches of the entire content.  That allows you to skip the labor-intensive process of creating hyperlinks.

• Add a 'Search the KnowledgeBase' box to allow pop-up, indexed searches of the KB. 

  Here, the problem is more complex as the articles in the KB are poorly indexed.  Often, the word one's looking for does not even appear in the article.  For example, if you don't already know to look for "policy routing," you can't find it by searching on "connect subnets."  In this area, I would suggest leaving the pre-V7 articles as-is, but making an effort to improve the indexing in light of my comment.  To the KB interface, you should include a feedback link that appears inside the article when displayed, and an invitation to suggest additional index words if the person initially searched on different terms.

  
  

Cheeers - Bob

Astaro should be soliciting these.  I would be glad to offer several I've created for no other payment than the mention "Contributed by Bob Alfson of MediaSoft, Inc."

I know theres been discussion about using wiki technology inside Astaro.  Wiki would handle this very well as the 'history' page for each article shows who contributed what if anyone cares.

The beauty of a KnowledgeBase moved to a wiki is that that can be done without much effort, and improvements can be achieved with little further effort by Astaro employees.  Then again, I think Astaro would be amazed at the improvement in customer service and the reduction in technical support requests if Astaro support engineers were required to spend a half-hour each day editing portions of the wiki related to issues dealt with that day.

Cheers - Bob

Astaro should be soliciting these.  I would be glad to offer several I've created for no other payment than the mention "Contributed by Bob Alfson of MediaSoft, Inc."

I know theres been discussion about using wiki technology inside Astaro.  Wiki would handle this very well as the 'history' page for each article shows who contributed what if anyone cares.

The beauty of a KnowledgeBase moved to a wiki is that that can be done without much effort, and improvements can be achieved with little further effort by Astaro employees.  Then again, I think Astaro would be amazed at the improvement in customer service and the reduction in technical support requests if Astaro support engineers were required to spend a half-hour each day editing portions of the wiki related to issues dealt with that day.

Cheers - Bob

See above post.