Suggestions for help topics

Here are my thoughts on the extrahelp, moreinfo topics.  

Since we have extrahelp and helptype I am wondering why we don’t also have an infotype to pair with moreinfo?  Based on the values of helptype it appears to be used for both help and info. For example,  I think that helptype includes:  automated, helpform, humanhelp, morehelp, simplified, and tooltips. 

Infotype would be associated with moreinfo and would include: dictionary, FAQs, glossary, simplified, thesaurus, tooltips, topicsearch. 

How do others feel, should we have helptype associated with extrahelp and (new)infotype associated with moreinfo or should all of the info and help types be grouped into one?  

Here are the additions I have made.  See this pull request:  https://github.com/w3c/personalization-semantics/pull/25 <https://github.com/w3c/personalization-semantics/pull/25>


extrahelp
Here is the property description I have proposed for extrahelp:

extrahelp provides users access to additional information about the current action or process in one or more formats.
A personalization agent may add additional explanatory text or provide an action for the user to take to obtain more detailed information or assistance in completing a task.

It still needs an example. 

morehelp
I have included the concept or redirecting to existing resources. I’m wondering if this could be confusing to people since it may direct them away from the current page?  Perhaps the idea is for the author to implement a mechanism to pull information from existing pages?  Authors definitely won’t want to duplicate existing information as this could be difficult to keep in sync depending upon their authoring environment. An alternative is to provide the information as a popup or overlay window?  Am I overthinking this - perhaps it is up the author to decide??

Here are some proposed definitions for morehelp:
automated - provides an alternative step by step sequence for completing a task or procedure.
helpform -  Used with forms when the user may need more or simplified information about the type of information being requested. Provides with a modified form with more information about each requested item.
humanhelp - Provides the user with access to human help. This may be through a live chat, providing a phone number to call for human assistance, or other mechanism to reach a person for direct assistance. 
morehelp - Provides a more detailed explanation about the current topic or process.
simplified - I think this should be easylang rather than simplified.  From the existing easylang description: provides, "a version of the content that is easier to read and understand.”

moreInfo (if morehelp is divided into separate lists)
dictionary - provides a definition of the term or topic. May redirect to another uri or provide the information in-line, via a popup, or other method.
faqs - redirects to a FAQ page with the related topic in view. 
glossary - provides a uri to a glossary page with the related topic in view.
simplified -  I think this should be easylang rather than simplified.  From the existing easylang description: provides, "a version of the content that is easier to read and understand.”
thesaurus - provides a list of synonyms for the current term.  May redirect to another uri or provide a list of synonyms in-line, via a popup, or other method. 
tooltips - offers an option of adding tooltips to provide morehelp with more detailed information about the current topic or process. 
topicsearch - provides a uri for the user to perform a search on the current topic with the suggested search term included


-becky

Received on Sunday, 7 January 2018 17:39:41 UTC