Use cases
This page is for creating use cases to test if different proposals for implementing the vocabularies can work.
Each use case should have a description, link to the requirement or easy language requirement and two code examples. Code example should include the AUI attributes and an example with the minim attributes possible.
links:
- the specification: https://w3c.github.io/personalization-semantics/#vocabulary-identification
- Vocabulary: It also has list of what is a tocken , uri and text attribute https://raw.githack.com/w3c/personalization-semantics/value-list/vocabulary-list/index.html
- requirements: https://rawgit.com/w3c/personalization-semantics/requirements/requirements/index.html#abstract
- wiki on implemetion : https://github.com/w3c/personalization-semantics/wiki/Comparison-of-ways-to-use-vocabulary-in-content
- wiki on implementation for 3 attributes : https://github.com/w3c/personalization-semantics/wiki/Comparison-of-ways-to-use-vocabulary-in-content#6c
- one can do a single attribute for may tokens if they are able to be separated with whitespace. In real life they have been shown to be confusing (by implementors- who do not always read and understand every word in the specification) as the context is not clear
- a single attribute for may text values: would require a very complex data model if it is even possible - all the disadvantages of value pairs come into play
- a single attribute for may URI value: would require a very complex data model if it is even possible- all the disadvantages of value pairs come into play
Someone who is either easily distracted or can be easily overwhelmed with too much information on a web page needs the ability to simplify the page to just the critical information and suppress anything that is not integral to the understanding and use of the page.
Example #1: You want to get the latest weather report for your city and go to www.weather.com website. Finding the actual weather forecast is actually a little challenging even if you have no disabilities. In addition to all the ads above, beside and below the information you actually want, there is also todays top stories, trending news, and social media to ignore. If you are easily overwhelmed or distracted getting the key information about the weather for today is a challenge. Having the ability to personalize and strip away all but the key information i.e. just the weather forecast for my city is critical for this person.
In this example the author of this webpage would mark the <section>, <p>, or <div> that contains the actual weather report and any associated the tools to manipulate the weather report (i.e. city search, hourly vs. 5 day forecast, etc.) as simplification=critical, and mark the other content as medium (default) or low.
For websites which rely on Ad revenue this may be difficult to completely suppress but maybe there is a way to move the more critical sections of a website above anything that is a lower priority.
Someone who has dyscalculia and therefore has difficulty understanding numbers will have a hard time with any website that uses numbers to convey information. This numeric information must be provided in an alternative format that the user can understand.
Example: You want to get the latest weather report for your city and go to www.weather.com website. For today’s forecast it shows a high of 95℉ and a low of 40℉, which is not helpful for this particular user. Allowing this numeric information to be presented instead as an image, symbol, or text would benefit the user. I.e. instead of 95℉ a picture of someone wearing shorts and a tee shirt with the sun above or simply saying “Very warm”, and instead of 40℉ a picture of someone wearing a jacket with pants, or say “Very cold”. Also for something like Humidity index of 90% could have an alternative of “muggy”.
In this example the author would have the numbers marked up in using numberfree where the default would show the numeric value but for those needing an alternative representation for numbers would get an associated image or description to be presented instead.
It is important to note that people with dyscalculia are often very good at words, so only long text can be better then short numbers.
Those who have a moderate Language Impairment / Learning Disability may have a limited vocabulary so they will only know terms that are in the core vocabulary that they have learnt. They also use symbols to represent words and concepts.
So they may know the word name, or last name , but have not learnt the term "family name". learning new tersm is very slow, requiring hours of work. Reading is also very slow so finding the right information can be a barrier. Symbols help people get to the section they need faster.
Solutions
- The ability to personalize a webpage and present symbols instead can help those easily understand the content being provided
Example: Marking up the Help button so the user agent can render a familiar term and allow the Symbol for help. EG `support /' may be rendered as / ? help (possibly as a tool tip)
- allow the author to add a simple language equivalent to complex put important text `h1 easylang="form to ask for money if you have a disability or if you are ill">Disability claims under CD 356 / US ' hear the user agent could replace the complex text with the simple text or put the simple text in a popup note the easy text may be longer
Note some people with language disabilities are good at numbers, so sometimes you will replace a long text with a short number ` normaly this is expected ' Note this is the opercit of the numberfree example
- Because reading is so slow they will also want less content and features as per the above use case
Those who have a severe speech and physical impairment the use of symbols to represent words is their primary means of communication for both consuming and producing information. Some users communicate through the use of symbols, rather than written text, as part of an Augmentative and Alternative Communication (AAC) system. Symbol users face a wide variety of barriers to accessing web content, but one of the main challenges is a lack of standard interoperability or a mechanism for translating how a concept is represented in one symbol set to how it may be represented in another symbol set.
Solutions for Symbol
Map symbol libraries to common concepts, so that symbols can be accurately converted to text in any language and then presented to other users in their preferred symbol library. The ability to personalize a webpage and present symbols instead can help those easily understand the content being provided.
Example: In this example the author would add symbol=”name space refrences for the image” ''
When there is more than one concept, multiple concepts can be referenced by separating them with white space. The order of multiple concepts should be subject predicate object. Both omissions and multiple triples are allowed.
Note that a unicef consortium is mapping the different open symbol libraries to a reference symbol (at blisssymbolics) to enable this. See the implementations page
Those who have a severe speech and physical impairment the use of symbols to represent words is their primary means of communication for both consuming and producing information. We will be focusing on the use of symbols to transform a textual based webpage into one that uses symbols instead so that this user can comprehend what is being provided since text alone is inadequate.
The ability to personalize a webpage and present symbols instead can help those easily understand the content being provided.
Example: Marking up the Home button and allowing for the Bliss Symbol for “Home Page”
will help this user better navigate the website.
In this example the author would add symbol=”URI to the symbol for homepage” or maybe a href to an image file.
Or would this be done at the UA level? Not sure how this will work, especially when you need multiple symbols to convey the textual phrase.
Use case: The user would prefer to see only the critical information and required fields to complete a task.
<div>
<form action="#" method="post"><br />
<p>Enter your e-mail address to subscribe to our mailing list.</p><br />
<label for="address">Enter email address:</label>
<input type="text" id="address" name="address"/></p><br />
<input type="submit" value="Subscribe" />
</form>
</div>
<div>
<form action="#" method="post"><br />
<p>Note: [*]denotes mandatory field</p>
<p>Enter your e-mail address to subscribe to our mailing list.</p><br />
<label for="address">Enter email address:</label>
<input type="text" id="address" name="address" aui-field="email" aui-simplification="critical" aria-
required="true"/>[*]</p><br />
<input type="submit" aui-simplification="critical" value="Subscribe" />
<br />
</form>
</div>
#Two token use cases
Use case: The user would prefer to see only the critical information and required fields to complete a task.
<div>
<button id="1">send</button>
<button id="2">undo</button>
<button id="3">lable</button>
<button id="4">send later</button>
<button id="5">mark urgentr</button>
</div>
<div>
<input type="submit" aui-simplification="critical" aui-action="send" value="send" />
<button id="2" aui-simplification="high" aui-action="undo">undo</button>
<button id="3" aui-simplification="normal">lable</button>
<button id="4" aui-simplification="normal">send later</button>
<button id="5" aui-simplification="normal" >mark urgentr</button>
</div>
<div>
<input type="submit" context ="critical send" value="send" />
<button id="2" context="high undo">undo</button>
<button id="3" context="normal">lable</button>
<button id="4" context="normal">send later</button>
<button id="5" context="normal" >mark urgentr</button>
</div>
User may have sensitivity to certain words or topics; based on personal preference, culture or disability which are expressed on a page using text, images or video.
Given one or more strings representing a specified word or category, for example, content marked as explicit, violent, etc., hide or remove that string and associated elements from the DOM.
- aui-action = hide
- URI = JSON file of words
Consideration: How are we bringing in data sets to support use cases that depend on external data, for example, symbols or simple language vocabularies? Is this through separate JS or is the vision to have that abstracted by the implementation.
Alternative (by lisa) aui-trigers = list of words
at the user end the content will be hiden under a warning button if any of the words match a word idendetifed as a tiger in the user prefrences
for example aui-trigers = "violent rape"
This example proved much harder to create than I expected. I will admit that I am still confused at how to create the examples and am not confident that these are correct. I also intended to have this be an example that needed two types of replacement but when I implemented it, I realized I could split it into two separate substitutions. becky
The user needs content that does not use numbers and needs extra help and information to complete a task.
<div>
7 out of 10 people order pizza with some kind of meat topping.
Select the toppings below in order of preference that you would
order on pizza.
</div>
<form>
sophisticated form to select/rank pizza toppings in order of preference
</form>
<div>
<span context="numberfree" easylang="most people">
7 out of 10 people
</span>
order pizza with some kind of meat topping.
<span context="extrahelp" reference="href-to-simplifiedInstructions">
Select the toppings below in order of preference that you would order on pizza.
</span>
</div>
<div>
<span aui-numberfree="Most people">
7 out of 10 people
</span>
order pizza with some kind of meat topping.
<span aui-extrahelp="href-to-simplifiedInstructions">
Select the toppings below in order of preference that
you would order on pizza.
</span>
</div>
Use case: The user prefers alternative text that does not use numerical concepts as well content that is easier to read and understand.
<p>
Comparing the present clock-reported time which is 5 minutes
after 09:00 AM with what we previously discussed
yesterday, and made an agreement about,
it seems that I myself may not be exactly on schedule
</p>
<div>
<span easylang="I'm running late">
Comparing the present clock-reported time which is
<span aui-numberfree="midmorning">
5 minutes after 09:00 AM
</span>
with what we previously discussed
yesterday, and made an agreement about, it seems that
I myself may not be exactly on schedule
</span>
</div>
Use case: we have two use cases
A. The user prefers alternative text that is easy to read and understand but is good with numbers (eg dyslexic)
<p>
Comparing the present clock-reported time
you many wish to come a bit later than the normal time.
</p>
<div>
<span aui-easylang="come to the meeting at 9:10">
Comparing the present clock-reported time you many wish
to come a bit later then the normal time
</span>
</div>
<div>
<span easylang="come to the meeting at 9:10">
Comparing the present clock-reported time
you many wish to come a bit later then the normal time
</span>
</div>
B: the user can understand words well but has dyscalculia and does not understand numbers
<p>
meeting is starting 10 minutes late
</p>
<div>
<span aui-easylang="come a bit later then the normal time - enough time for a cup of tea... ">
meeting is starting 10 minutes late
</span>
</div>
<div>
<span easylang="come a bit later then the normal time - enough time for a cup of tea... " context="numbers">
meeting is starting 10 minuets late
</span>
</div>
Use case: The user needs
- easy language and
- a bit more information about how the interface works
- what just happened - i.e. did they need to click something else, did it work?
In this example search criteria in one part of a page controls the results in anther region which showes the side effects of a drug. Other buttons may show dosage etc in the results region
<input
aui-context ="critical" value="refresh" aria-controls="region2"
/>
<input aui-simplification="critical"
aui-feedback="the results now are for ibuprofen side effect"
value="refresh"
aria-controls="region2"
aui-easyLang="get the side effects"
aui-explain="press this button to see the side effects of a drug"
/>
I could not do this in three attributes. So I did what I could
<input
context="critical"
aui-feedback="the results now are for ibuprofen side effect"
value="refresh"
aria-controls="region2"
aui-easyLang="get the side effects"
aui-explain="press this button to see the side effects of a drug"
/>
Use case: The user needs
- symbols
- extra text and help
<div>
<strong>warning</strong>
in the event of a siren go to the designated protected area
</div>
<div>
<strong region="warning">warning</strong>
<span aui-symbol="blis.org/siren"> in the event of a siren </span>
<span aui-symbol="blis.org/goto"> go to </span>
<span aui-symbol="blis.org/shelter"
aui-extrahelp=mysite/whatisashelter-easylang.html">the designated protected area
</span>
</div>
I could not do it in three
this is the best I can do
<div>
<strong context="warning">warning</strong>
<span reference="blis.org/siren">in the event of a siren</span>
<span reference="blis.org/goto"> go to </span>
<span reference="blis.org/shelter" extrahelp=mysite/whatisashelter-easylang.html">
the designated protected area
</span>
</div>