Help us enhance your Sophos Community experience. Share your thoughts in our Sophos Community survey.

Thread Info
  • State Not Answered
  • Replies 24 replies
  • Subscribers 0 subscribers
  • Views 13301 views
  • Users 0 members are here
Options
Suggested

Improving the Online Help

FormerMember
FormerMember
Hi,

this subforum is new and dedicated to Astaro's help formats Online Help & PDF.

This is your chance to improve the quality of the help!
Tell us

  • what you miss in the help
  • what you don't understand in the help
  • what is explained in too much detail or too verbosely
  • general mistakes


Thanks for your dedication and support!
Parents
  • 0
    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
     
    Sophos UTM Community Moderator
    Sophos Certified Architect - UTM
    Sophos Certified Engineer - XG
    Gold Solution Partner since 2005
    MediaSoft, Inc. USA
  • FormerMember
    0 FormerMember in reply to BAlfson
    Hi BAlfson,

    thank you for your warm welcome and your ideas.
    So far, I can say that the implementation of a search function in our online help is already planned. (I proposed this function myself some weeks ago [;)] )

    Regarding the Knowledge Base, we need to validate how we want to improve it. Whether there will be a wiki or not, I can't say right now, but I see your strong Pro arguments.
Reply
  • FormerMember
    0 FormerMember in reply to BAlfson
    Hi BAlfson,

    thank you for your warm welcome and your ideas.
    So far, I can say that the implementation of a search function in our online help is already planned. (I proposed this function myself some weeks ago [;)] )

    Regarding the Knowledge Base, we need to validate how we want to improve it. Whether there will be a wiki or not, I can't say right now, but I see your strong Pro arguments.
Children
No Data
Unfiltered HTML