- From: Janina Sajka <janina@rednote.net>
- Date: Mon, 15 Jun 2020 11:50:17 -0400
- To: John Foliot <john.foliot@deque.com>
- Cc: public-personalization-tf <public-personalization-tf@w3.org>
Hi, John:
Thanks for this. I think we're making good progress.
Re your question about referencing working drafts. --I don't believe so.
Certainly not in a normative way. Do we have references to something
that never made it beyond WD, and is 2005 vintage besides?
Best,
Janina
John Foliot writes:
> ---------- Forwarded message ---------
> From: John Foliot <john.foliot@deque.com>
> Date: Fri, Jun 12, 2020 at 4:40 PM
> Subject: "Red Pencil" edits to Personalization Semantics Content Module 1.0
> To: w3c/personalization-semantics <
> personalization-semantics@noreply.github.com>
>
>
> All,
>
> After Monday's call, I took the task of doing a "red pencil" review/edit of
> our Personalization Semantics Content Module 1.0, which you will
> find attached.
>
> Please note that I did this review in MS Word, with "Track changes" turned
> on so that we can all see what changes I am proposing. Most of the edits
> were minor, although a question for Michael Cooper/Roy: can W3C Recs
> reference W3C Drafts (SKOS Core Guide - W3C *Working Draft* 2 November
> 2005)? (Janina?)
>
> FWIW, I tracked down two of the missing references for that Final section.
>
> JF
> --
> *John Foliot* | Principal Accessibility Strategist | W3C AC Representative
> Deque Systems - Accessibility for Good
> deque.com
> "I made this so long because I did not have time to make it shorter." -
> Pascal "links go places, buttons do things"
>
>
>
>
>
> --
> *John Foliot* | Principal Accessibility Strategist | W3C AC Representative
> Deque Systems - Accessibility for Good
> deque.com
> "I made this so long because I did not have time to make it shorter." -
> Pascal "links go places, buttons do things"
> **Personalization Semantics Content Module 1.0**
>
> W3C Editor\'s Draft 12 June 2020
>
> **This version:**
>
> > [[https://w3c.github.io/personalization-semantics/content/]{.underline}](https://w3c.github.io/personalization-semantics/content/)
> >
> > **Latest published version:**
> >
> > [[https://www.w3.org/TR/personalization-semantics-content-1.0/]{.underline}](https://www.w3.org/TR/personalization-semantics-content-1.0/)
> >
> > **Latest editor\'s draft:**
> >
> > [[https://w3c.github.io/personalization-semantics/content/]{.underline}](https://w3c.github.io/personalization-semantics/content/)
> >
> > **Editors:**
> >
> > [[Lisa Seeman]{.underline}](mailto:lisa.seeman@zoho.com)
> >
> > [[Charles
> > LaPierre]{.underline}](mailto:charlesl@benetech.org) (Benetech)
> >
> > [[Michael Cooper]{.underline}](mailto:cooper@w3.org) (W3C)
> >
> > [[Roy Ran]{.underline}](mailto:ran@w3.org) (W3C)
> >
> > Richard
> > Schwerdtfeger ([[Knowbility]{.underline}](https://www.knowbility.org/))
> > (Editor until October 2017)
> >
> > [[Copyright]{.underline}](https://www.w3.org/Consortium/Legal/ipr-notice#Copyright) ©
> > 2017-2020 [[W3C]{.underline}](https://www.w3.org/)^®^ ([[MIT]{.underline}](https://www.csail.mit.edu/), [[ERCIM]{.underline}](https://www.ercim.eu/), [[Keio]{.underline}](https://www.keio.ac.jp/), [[Beihang]{.underline}](https://ev.buaa.edu.cn/)). W3C [[liability]{.underline}](https://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer), [[trademark]{.underline}](https://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks) and [[document
> > use]{.underline}](https://www.w3.org/Consortium/Legal/copyright-documents) rules
> > apply.
>
> Abstract
>
> > This document provides use cases and a vocabulary of terms that can be
> > used to enhance web content by providing information about form
> > controls, symbols, and other user interface elements. User agents use
> > the semantics to augment or adapt content to the user's scenario. This
> > helps users with varying needs to understand the content by providing
> > support for simplification and a way to manage unnecessary
> > distractions.
> >
> > The Personalization Semantics Content Module 1.0 is an extension of
> > the personalization semantics introduced in the [[Personalization
> > Semantics Explainer
> > 1.0]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/) document \[[[personalization-semantics-1.0]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#bib-personalization-semantics-1.0)\].
>
> Status of This Document
>
> > *This section describes the status of this document at the time of its
> > publication. Other documents may supersede this document. A list of
> > current W3C publications and the latest revision of this technical
> > report can be found in the [[W3C technical reports
> > index]{.underline}](https://www.w3.org/TR/) at
> > https://www.w3.org/TR/.*
> >
> > This document was published by the [[Accessible Platform Architectures
> > Working Group]{.underline}](https://www.w3.org/WAI/APA/) as
> > an Editor\'s Draft.
> >
> > Comments regarding this document are welcome. Please send them
> > to [[public-personalization-tf\@w3.org]{.underline}](mailto:public-personalization-tf@w3.org) ([[archives]{.underline}](https://lists.w3.org/Archives/Public/public-personalization-tf/)).
> >
> > Publication as an Editor\'s Draft does not imply endorsement by
> > the W3C Membership. This is a draft document and may be updated,
> > replaced or obsoleted by other documents at any time. It is
> > inappropriate to cite this document as other than work in progress.
> >
> > This document was produced by a group operating under the [[W3C Patent
> > Policy]{.underline}](https://www.w3.org/Consortium/Patent-Policy/). W3C maintains
> > a [[public list of any patent
> > disclosures]{.underline}](https://www.w3.org/2004/01/pp-impl/83907/status) made
> > in connection with the deliverables of the group; that page also
> > includes instructions for disclosing a patent. An individual who has
> > actual knowledge of a patent which the individual believes
> > contains [[Essential
> > Claim(s)]{.underline}](https://www.w3.org/Consortium/Patent-Policy/#def-essential) must
> > disclose the information in accordance with [[section 6 of
> > the W3C Patent
> > Policy]{.underline}](https://www.w3.org/Consortium/Patent-Policy/#sec-Disclosure).
> >
> > This document is governed by the [[1 March 2019 W3C Process
> > Document]{.underline}](https://www.w3.org/2019/Process-20190301/).
> >
> > 1. Introduction
> >
> > *This section is non-normative.*
> >
> > 1.1 Background on Personalization Semantics
> >
> > This specification is designed to enable authors to add extra semantic
> > information at the element level about content to enable
> > personalization for the individual user, including providing extra
> > support and enabling user agents for people with learning and
> > cognitive disabilities.
> >
> > The goal of these attributes and values is to enable personalization
> > for the individual user, including providing extra support,
> > transforming the user interface (UI) through the addition, removal, or
> > adaptation of content that has a negative impact on the primary
> > user-group, and enabling new user agents for people with learning and
> > cognitive disabilities.
> >
> > Personalization semantics is a series of technical specifications that
> > provide element-level attributes and values to enable user agents and
> > helper-applications to adapt the content for the individual needs of
> > the user. Rather than developing complex solutions for a wide range of
> > users, authors can add personalization semantics, so that the content
> > can be personalized to the needs of each user. The aim is to provide
> > more optimal accessibility, including providing extra support,
> > transforming the user interface (UI) through the addition, removal, or
> > adaptation of content that has a negative impact on the primary
> > user-group, and enabling new user agents for people with learning and
> > cognitive disabilities.
> >
> > The Personalization Semantics Recommendation will consist of three
> > modules: Content, Help and Support, Tools. This Personalization
> > Semantics Content Module specification is one of personalization
> > semantics modules.
> >
> > Personalization Semantics are fully introduced in our [[Explainer for
> > Personalization
> > Wiki]{.underline}](https://github.com/w3c/personalization-semantics/wiki/Explainer-for-Personalization-Semantics) and \[[[personalization-semantics-1.0]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#bib-personalization-semantics-1.0)\].
> >
> > 1.2 Personalization Semantics Content Module
> >
> > Personalization Semantics Content Module is the first part of the
> > Personalization Semantics technical specification, which provides
> > personalization semantics and vocabularies that can be used to
> > annotate web content with additional semantic information, enabling
> > user agents to augment or adapt content to various user-scenarios
> > based on the user's personalization settings or preferences. The
> > Content Module enhances web content by providing additional
> > information about form controls, buttons, links, and other user
> > interface elements. User agents use these semantics to augment or
> > adapt content to the user's scenario -- for example allowing for the
> > conversion of text to symbols. This helps users with varying needs to
> > understand the content by providing support for simplification and/or
> > a way to manage unnecessary distractions.
> >
> > 1.3 Vocabulary Structure and Implementations
> >
> > All the vocabularies used in the Personalization Semantics Content
> > Module consists of attributes and their values. Those values are
> > either one of a fixed token list (taxonomy), or in some instances
> > string text. Please see our [[Explainer for Personalization
> > Wiki]{.underline}](https://github.com/w3c/personalization-semantics/wiki/Explainer-for-Personalization-Semantics).
> >
> > The vocabulary implementations included in this document are available
> > at our [[implementations wiki
> > page]{.underline}](https://github.com/w3c/personalization-semantics/wiki/Implementations-of-Semantics).
> >
> > 1.4 Use Cases and Requirements
> >
> > The [[Requirements for Personalization
> > Semantics]{.underline}](https://github.com/w3c/personalization-semantics/wiki/Requirements) describes
> > use cases and requirements. This module provides properties to fulfill
> > requirements related to adaptable content.
> >
> > 2. Terms
> >
> >
> >
> > **Age Appropriate Forgetfulness (sometimes called "age related memory
> > loss")**
> >
> >
> >
> > People with age appropriate forgetfulness have impaired memory issues
> > that can be a normal part of healthy aging. They may take longer to
> > learn new things, forget something but remember it later, or
> > occasionally forget particular words. (This differs from dementia
> > where forgetfulness is due to a disorder and is more pronounced.)
> >
> >
> >
> > **Alternative and Augmentative Communication System (sometimes
> > referred to as "AAC")**
> >
> >
> >
> > Any method, device or app that can be used to help those who cannot
> > use spoken language and need additional support by means of symbols,
> > images and/or text. For example a screen with symbols that the user
> > can select to speak the appropriate words or add them to a document.
> >
> > EDITOR\'S NOTE
> >
> > We intend to incorporate additional terms from the glossary from
> > the Cognitive and Learning Disabilities Accessibility Task Force, when
> > it is ready. If there are non editorial differences, we will use the
> > term definitions above. See the [[COGA
> > Glossary]{.underline}](https://raw.githack.com/w3c/coga/Glossary-draft/glossary/index.html).
> >
> > 3. Content
> >
> > EDITOR\'S NOTE
> >
> > Since implementation has not yet been finalized any examples in this
> > document are purely for help in understanding the concept. All
> > examples will be updated once a final decision has been made on the
> > method for implementation.
> >
> > 3.1 action
> >
> > **3.1.1 Description**
> >
> > The action attribute provides the context of a button. It is typically
> > used on a button element or element with role=\"button\".
> >
> > **3.1.2 Example**
> >
> > Here is an example using the action attribute.
> >
> > [[EXAMPLE 1]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-1-action-using-data): Action
> > using data-action
> >
> > \<**button** data-action=\"undo\"\>Revert\</**button**\>
> >
> > A personalization agent may add a symbol, replace the text with a more
> > familiar term, or give it a specific presentation. Note that there is
> > no default value.
> >
> > **3.1.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[link |
> | | > types]{.underline}*](https://ww |
> | | w.w3.org/TR/html52/links.html#sec |
> | | -link-types) \[[[HTML52]{.underli |
> | | ne}](https://raw.githack.com/w3c/ |
> | | personalization-semantics/edits07 |
> | | 062020/content/index.html#bib-htm |
> | | l52)\] and [*[HTML types]{.underl |
> | | ine}*](https://www.w3.org/TR/html |
> | | 5/forms.html#states-of-the-type-a |
> | | ttribute) \[[[HTML5]{.underline}] |
> | | (https://raw.githack.com/w3c/pers |
> | | onalization-semantics/edits070620 |
> | | 20/content/index.html#bib-html5)\ |
> | | ] |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[token]{.underline}](https://r |
> | | aw.githack.com/w3c/personalizatio |
> | | n-semantics/edits07062020/content |
> | | /index.html#valuetype_token) |
> +-----------------------------------+-----------------------------------+
>
> > The following could be supported values of action for buttons. Note
> > that the following items represent an option or control that allows
> > you to perform the action. They do not represent page regions.
> >
> > **3.1.4 Values**
>
> +-----------------------------------+-----------------------------------+
> | > **Value** | > **Description** |
> +===================================+===================================+
> | > **add** | > Add the selected item or the |
> | | > item at the current location to |
> | | > a list. |
> +-----------------------------------+-----------------------------------+
> | > **brightness** | > Adjust the screen or |
> | | > application brightness. Often |
> | | > used with increase or decrease |
> | | > but is sometimes used alone as |
> | | > a menu name or item. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **buy** | > Buy the selected item or buy |
> | | > the item at the current |
> | | > location. Often involves adding |
> | | > the current item into a |
> | | > shopping cart. (Implied |
> | | > simplification = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **cancel** | > Closes the dialog and discards |
> | | > any changes the user may have |
> | | > made within that dialog. |
> | | > (Implied simplification = |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **captions** | > Show the settings for captions |
> | | > and subtitles. |
> +-----------------------------------+-----------------------------------+
> | > **channel** | > Adjust the channel of a |
> | | > multimedia component. Often |
> | | > used with increase or decrease |
> | | > but is sometimes used alone as |
> | | > a menu name or item. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **checkout** | > Proceed to the purchasing |
> | | > process. (Implied |
> | | > simplification = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **close** | > Close the current dialog. |
> | | > (Implied simplification = |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **color** | > Opens a color picker. |
> +-----------------------------------+-----------------------------------+
> | > **compose** | > Compose a new item such as an |
> | | > email. (Implied simplification |
> | | > = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **confirm** | > Confirms submission of the form |
> | | > request to the server. For |
> | | > example, an \"ok\" button. |
> | | > (Implied simplification = |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **connect** | > Connect to a communication |
> | | > channel, such as an FTP server |
> | | > or Voice over IP channel. Often |
> | | > used with \[aria-pressed = |
> | | > \"true\"\] for on or |
> | | > \[aria-pressed = \"false\"\] |
> | | > for off. |
> +-----------------------------------+-----------------------------------+
> | > **copy** | > Copies the selected control, |
> | | > item or text and places it onto |
> | | > the clipboard. |
> +-----------------------------------+-----------------------------------+
> | > **cut** | > Removes the selected control, |
> | | > item or text and places it onto |
> | | > the clipboard. |
> +-----------------------------------+-----------------------------------+
> | > **date** | > Opens a date control. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **decrease** | > Decreases the level of the |
> | | > relevant setting. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **delete** | > Delete the current item, |
> | | > selected control, or text. |
> +-----------------------------------+-----------------------------------+
> | > **download** | > Download a file from the |
> | | > server. |
> +-----------------------------------+-----------------------------------+
> | > **drag** | > Enables drag and drop |
> | | > capabilities. Often used with |
> | | > \[aria-pressed = \"true\"\] for |
> | | > on or \[aria-pressed = |
> | | > \"false\"\] for off. |
> +-----------------------------------+-----------------------------------+
> | > **edit** | > Edit the item or selection at |
> | | > the current location. |
> +-----------------------------------+-----------------------------------+
> | > **escape** | > Typically used to abort, cancel |
> | | > or change what is currently |
> | | > being displayed on the screen. |
> | | > A common application of the the |
> | | > esc key is to leave full screen |
> | | > mode. |
> +-----------------------------------+-----------------------------------+
> | > **expand** | > Expand or collapse the current |
> | | > item. |
> +-----------------------------------+-----------------------------------+
> | > **forward** | > Forward the current item such |
> | | > as an email. |
> +-----------------------------------+-----------------------------------+
> | > **opens-in-page-help** | > Opens a help function on the |
> | | > same page. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **increase** | > Increases the level of the |
> | | > relevant setting. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **label** | > Add a label to the selected |
> | | > item or the item at the current |
> | | > location. |
> +-----------------------------------+-----------------------------------+
> | > **language** | > Ability to select the preferred |
> | | > language for the content. |
> +-----------------------------------+-----------------------------------+
> | > **left** | > Changes the location of the |
> | | > selected item(s) to the left. |
> +-----------------------------------+-----------------------------------+
> | > **loop** | > Plays the flow, presentation, |
> | | > or a movie over and over again, |
> | | > once or without stopping. Often |
> | | > used with \[aria-pressed = |
> | | > \"true\"\] for on or |
> | | > \[aria-pressed = \"false\"\] |
> | | > for off. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **media-position** | > Adjust the current playback |
> | | > position in the current media. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **mode** | > Change the mode or |
> | | > functionality. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **more** | > Show more information. |
> +-----------------------------------+-----------------------------------+
> | > **move** | > Changes the position of a |
> | | > selected item(s). Often used |
> | | > with left, right, begin, end, |
> | | > increase (up) or decrease |
> | | > (down). |
> +-----------------------------------+-----------------------------------+
> | > **mute** | > Mute or toggle the mute option. |
> +-----------------------------------+-----------------------------------+
> | > **new** | > Open a new item. (Implied |
> | | > simplification= \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **next** | > Go to the next item in the |
> | | > series. (Implied simplification |
> | | > = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **open** | > Open an item. (Implied |
> | | > simplification = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **order** | > Changes the position of the |
> | | > selected item within a list of |
> | | > items, while each item in the |
> | | > list has a layer position. |
> | | > Often used with increase |
> | | > (forward), decrease (back), |
> | | > first and end. |
> +-----------------------------------+-----------------------------------+
> | > **paste** | > Paste the content from the |
> | | > clipboard to the current |
> | | > position. |
> +-----------------------------------+-----------------------------------+
> | > **pause** | > Pause a multimedia, audio or |
> | | > video element or object. |
> | | > (Implied simplification= |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **play** | > Play a multimedia, audio or |
> | | > video element or object. |
> | | > (Implied simplification= |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **previous** | > Go to the previous item in the |
> | | > series. (Implied simplification |
> | | > = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **print** | > Print the current page, |
> | | > selection or the item at the |
> | | > current location. |
> +-----------------------------------+-----------------------------------+
> | > **profile** | > Opens the user\'s profile page. |
> +-----------------------------------+-----------------------------------+
> | > **properties** | > Shows the properties of an |
> | | > item. |
> +-----------------------------------+-----------------------------------+
> | > **received** | > Open the received folder. |
> +-----------------------------------+-----------------------------------+
> | > **refresh** | > Manually refresh the current |
> | | > contents of the screen. |
> +-----------------------------------+-----------------------------------+
> | > **remove** | > Removes an item from a list. |
> +-----------------------------------+-----------------------------------+
> | > **reply** | > Reply to the current item such |
> | | > as an email. (Implied |
> | | > simplification = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **reset** | > Resets all the controls to |
> | | > their initial values. |
> +-----------------------------------+-----------------------------------+
> | > **resize** | > Increase or decrease the font |
> | | > size. Often used with increase |
> | | > or decrease. |
> +-----------------------------------+-----------------------------------+
> | > **right** | > Changes the location of the |
> | | > selected item(s) to the right. |
> +-----------------------------------+-----------------------------------+
> | > **save** | > Save the current content. |
> | | > (Implied simplification = |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **scroll** | > Advances the view. Often used |
> | | > with left, right, begin, end, |
> | | > increase (up) or decrease |
> | | > (down). |
> +-----------------------------------+-----------------------------------+
> | > **send** | > Send a form, email or request. |
> | | > (Implied simplification = |
> | | > \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **sent** | > Open the sent folder. |
> +-----------------------------------+-----------------------------------+
> | > **settings** | > Open settings and options. |
> +-----------------------------------+-----------------------------------+
> | > **skip** | > Skips the current step. This is |
> | | > typically used in a sequence of |
> | | > steps. |
> +-----------------------------------+-----------------------------------+
> | > **submit** | > Submits the form data or a |
> | | > request to the server. (Implied |
> | | > simplification = \"critical\".) |
> +-----------------------------------+-----------------------------------+
> | > **temperature** | > Adjust the temperature. Often |
> | | > used with increase or decrease |
> | | > but is sometimes used alone as |
> | | > a menu name or item. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **toc** | > Opens a table of contents. |
> +-----------------------------------+-----------------------------------+
> | > **undo** | > Revert back to the prior state |
> | | > before the user\'s most recent |
> | | > changes. |
> +-----------------------------------+-----------------------------------+
> | > **upload** | > Upload a file to the server. |
> +-----------------------------------+-----------------------------------+
> | > **voice-commands** | > Activate or deactivate voice |
> | | > commands. Often used with |
> | | > \[aria-pressed = \"true\"\] for |
> | | > on or \[aria-pressed = |
> | | > \"false\"\] for off. |
> +-----------------------------------+-----------------------------------+
> | > **volume** | > Adjust the volume of a |
> | | > multimedia component. Often |
> | | > used with increase or decrease |
> | | > but is sometimes used alone as |
> | | > a menu name or item. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
>
> > 3.2 destination
> >
> > **3.2.1 Description**
> >
> > The destination attribute categorizes the target of a hyperlink.
> >
> > A personalization agent or user agent may add additional familiar user
> > interface features to help users understand the link and follow the
> > right one easily. User agents might add a familiar customized icon to
> > the link, or style the link in a customized way, or position the link
> > on the page in a location that the user generally expects to find a
> > link of the particular type.
> >
> > **3.2.2 Example**
> >
> > The below example section show how destination used when coding.
> >
> > [[EXAMPLE 2]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-2-destination-using-data): Destination
> > using data-destination
> >
> > \<**a** href=\"home.html\" data-destination=\"home\"\>our main
> > page\</**a**\>
> >
> > See the [[destination sample user
> > experience]{.underline}](https://rawgit.com/ayelet-seeman/coga.personalisation/demo/conactUs.html).
> >
> > **3.2.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[link |
> | | > types]{.underline}*](https://ww |
> | | w.w3.org/TR/html52/links.html#sec |
> | | -link-types) \[[[HTML52]{.underli |
> | | ne}](https://raw.githack.com/w3c/ |
> | | personalization-semantics/edits07 |
> | | 062020/content/index.html#bib-htm |
> | | l52)\] and [*[HTML 5.2 autocomple |
> | | te]{.underline}*](https://www.w3. |
> | | org/TR/html52/sec-forms.html#auto |
> | | filling-form-controls-the-autocom |
> | | plete-attribute) \[[[HTML52]{.und |
> | | erline}](https://raw.githack.com/ |
> | | w3c/personalization-semantics/edi |
> | | ts07062020/content/index.html#bib |
> | | -html52)\] |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[token]{.underline}](https://r |
> | | aw.githack.com/w3c/personalizatio |
> | | n-semantics/edits07062020/content |
> | | /index.html#valuetype_token) |
> +-----------------------------------+-----------------------------------+
>
> > **3.2.4 Values**
>
> +-----------------------------------+-----------------------------------+
> | > **Value** | > **Description** |
> +===================================+===================================+
> | > **about** | > Information about the content |
> | | > owner or producer. |
> +-----------------------------------+-----------------------------------+
> | > **accessibility-statement** | > Information about the |
> | | > accessibility features in a web |
> | | > site or web content. |
> +-----------------------------------+-----------------------------------+
> | > **begin** | > Changes the location to the |
> | | > beginning item from a list of |
> | | > items or redirects the |
> | | > functionality to the first step |
> | | > in a sequence. |
> +-----------------------------------+-----------------------------------+
> | > **chat** | > Human help or a dialog help |
> | | > function such as a chat bot. |
> +-----------------------------------+-----------------------------------+
> | > **contact** | > Opens contact information for |
> | | > content owner or producer. |
> +-----------------------------------+-----------------------------------+
> | > **email-recipient** | > Email address for the content |
> | | > owner or producer. |
> +-----------------------------------+-----------------------------------+
> | > **end** | > Changes the location to the end |
> | | > item from a list of items or |
> | | > redirects the functionality to |
> | | > the last step in a sequence. |
> +-----------------------------------+-----------------------------------+
> | > **feedback** | > Submit feedback or comment on |
> | | > the current item. |
> +-----------------------------------+-----------------------------------+
> | > **help** | > A help function that navigates |
> | | > to support or instructions. |
> +-----------------------------------+-----------------------------------+
> | > **home** | > Initial or main page of a |
> | | > website or application. |
> +-----------------------------------+-----------------------------------+
> | > **phone** | > Phone number for the content |
> | | > owner or producer. |
> +-----------------------------------+-----------------------------------+
> | > **post** | > Post current item. Item will be |
> | | > visible to other parties. |
> +-----------------------------------+-----------------------------------+
> | > **products** | > Products available from the |
> | | > content provider. |
> +-----------------------------------+-----------------------------------+
> | > **related** | > Adds a related item(s) to a |
> | | > pre-selected list of items. |
> +-----------------------------------+-----------------------------------+
> | > **services** | > Services available from the |
> | | > content provider. |
> +-----------------------------------+-----------------------------------+
> | > **signin** | > Sign-in to the current web site |
> | | > or application. |
> +-----------------------------------+-----------------------------------+
> | > **signout** | > Sign-out of the current web |
> | | > site or application. |
> +-----------------------------------+-----------------------------------+
> | > **sitemap** | > Content containing a list of |
> | | > all the pages in a web site. |
> +-----------------------------------+-----------------------------------+
> | > **social** | > Content provider on a social |
> | | > media platform. Note, that the |
> | | > specific name of the social |
> | | > media platform should be |
> | | > included in the accessible |
> | | > name. |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **terms** | > The terms and conditions of use |
> | | > applicable to the website or |
> | | > web content. |
> +-----------------------------------+-----------------------------------+
> | > **tools** | > Available tools for the current |
> | | > content. |
> +-----------------------------------+-----------------------------------+
>
> > 3.3 purpose
> >
> > **3.3.1 Description**
> >
> > The purpose attribute provides the context of a text input field such
> > as a text box. It is typically used on an input of type text, or
> > element with a corresponding role.
> >
> > A personalization agent may add a symbol, replace the text with a more
> > familiar term, or give it a specific presentation. Note that there is
> > no default value.
> >
> > The user experience may include filling in the field and adding an
> > icon.
> >
> > The purpose values that would typically be on form controls should
> > provide context for the user. For example tel would relate to the
> > user\'s telephone number. Note that there is no default value and
> > there can be more than one value for a field, such
> > as data-purpose=\"country-name postal-code\" which includes both the
> > country and postal code.
> >
> > **3.3.2 Example**
> >
> > Here is an example using the purpose attribute when coding.
> >
> > [[EXAMPLE 3]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-3-field-using-data): Field
> > using data-purpose
> >
> > \<**input** type=\"text\" name=\"telephonenum\"
> > data-purpose=\"tel\"/\>
> >
> > **3.3.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[link |
> | | > types]{.underline}*](https://ww |
> | | w.w3.org/TR/html52/links.html#sec |
> | | -link-types) \[[[HTML52]{.underli |
> | | ne}](https://raw.githack.com/w3c/ |
> | | personalization-semantics/edits07 |
> | | 062020/content/index.html#bib-htm |
> | | l52)\] and [*[HTML types]{.underl |
> | | ine}*](https://www.w3.org/TR/html |
> | | 5/forms.html#states-of-the-type-a |
> | | ttribute) \[[[HTML5]{.underline}] |
> | | (https://raw.githack.com/w3c/pers |
> | | onalization-semantics/edits070620 |
> | | 20/content/index.html#bib-html5)\ |
> | | ] |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[token]{.underline}](https://r |
> | | aw.githack.com/w3c/personalizatio |
> | | n-semantics/edits07062020/content |
> | | /index.html#valuetype_token) |
> +-----------------------------------+-----------------------------------+
>
> > **3.3.4 Values**
>
> +-----------------------------------+-----------------------------------+
> | > **Value** | > **Description** |
> +===================================+===================================+
> | > **additional-name** | > Additional names (in some |
> | | > Western cultures, also known as |
> | | > middle names, forenames other |
> | | > than the first name). |
> +-----------------------------------+-----------------------------------+
> | > **additional-name-initial** | > Additional or middle name |
> | | > initial. |
> +-----------------------------------+-----------------------------------+
> | > **address-level1** | > The broadest administrative |
> | | > level in the address, i.e., the |
> | | > province within which the |
> | | > locality is found; for example, |
> | | > in the US, this would be the |
> | | > state; in Switzerland it would |
> | | > be the canton; in the UK, the |
> | | > post town. |
> +-----------------------------------+-----------------------------------+
> | > **address-level2** | > The second administrative |
> | | > level, in addresses with two or |
> | | > more administrative levels; in |
> | | > the countries with two |
> | | > administrative levels, this |
> | | > would typically be the city, |
> | | > town, village, or other |
> | | > locality within which the |
> | | > relevant street address is |
> | | > found. |
> +-----------------------------------+-----------------------------------+
> | > **address-level3** | > The third administrative level, |
> | | > in addresses with three or more |
> | | > administrative levels. |
> +-----------------------------------+-----------------------------------+
> | > **address-level4** | > The most fine-grained |
> | | > administrative level, in |
> | | > addresses with four |
> | | > administrative levels. |
> +-----------------------------------+-----------------------------------+
> | > **address-line1** | > Street address (one line per |
> | | > field, line 1) |
> +-----------------------------------+-----------------------------------+
> | > **address-line2** | > Street address (one line per |
> | | > field, line 2) |
> +-----------------------------------+-----------------------------------+
> | > **address-line3** | > Street address (one line per |
> | | > field, line 3) |
> +-----------------------------------+-----------------------------------+
> | > **answer** | > Answer to a section question. |
> +-----------------------------------+-----------------------------------+
> | > **area** | > Administrative area, state, |
> | | > province, or region. |
> +-----------------------------------+-----------------------------------+
> | > **bday** | > Birthday. |
> +-----------------------------------+-----------------------------------+
> | > **bday-day** | > Day component of birthday. |
> +-----------------------------------+-----------------------------------+
> | > **bday-month** | > Month component of birthday. |
> +-----------------------------------+-----------------------------------+
> | > **bday-year** | > Year component of birthday. |
> +-----------------------------------+-----------------------------------+
> | > **cc-csc** | > Security code for the payment |
> | | > instrument (also known as the |
> | | > card security code (CSC), card |
> | | > validation code (CVC), card |
> | | > verification value (CVV), |
> | | > signature panel code (SPC), |
> | | > credit card ID (CCID), etc). |
> +-----------------------------------+-----------------------------------+
> | > **cc-exp** | > Expiration date of the payment |
> | | > instrument. |
> +-----------------------------------+-----------------------------------+
> | > **cc-exp-month** | > Month component of the |
> | | > expiration date of the payment |
> | | > instrument. |
> +-----------------------------------+-----------------------------------+
> | > **cc-exp-year** | > Year component of the |
> | | > expiration date of the payment |
> | | > instrument. |
> +-----------------------------------+-----------------------------------+
> | > **cc-name** | > Full name as given on the |
> | | > payment instrument. |
> +-----------------------------------+-----------------------------------+
> | > **cc-number** | > Code identifying the payment |
> | | > instrument (e.g., the credit |
> | | > card number). |
> +-----------------------------------+-----------------------------------+
> | > **cc-type** | > Type of payment instrument. |
> +-----------------------------------+-----------------------------------+
> | > **cc-given-name** | > Given name as given on the |
> | | > payment instrument (in some |
> | | > Western cultures, also known as |
> | | > the first name). |
> +-----------------------------------+-----------------------------------+
> | > **cc-additional-name** | > Additional names given on the |
> | | > payment instrument (in some |
> | | > Western cultures, also known as |
> | | > middle names, forenames other |
> | | > than the first name). |
> +-----------------------------------+-----------------------------------+
> | > **cc-family-name** | > Family name given on the |
> | | > payment instrument (in some |
> | | > Western cultures, also known as |
> | | > the last name or surname. |
> +-----------------------------------+-----------------------------------+
> | > **comment** | > Form comment section. |
> | | > Typically, a free text field. |
> +-----------------------------------+-----------------------------------+
> | > **country** | > Country code. |
> +-----------------------------------+-----------------------------------+
> | > **country-name** | > Country name. |
> +-----------------------------------+-----------------------------------+
> | > **current-password** | > The current password for the |
> | | > account identified by the |
> | | > username field (e.g., when |
> | | > logging in). |
> +-----------------------------------+-----------------------------------+
> | > **date-end** | > Set the end time of an event |
> | | > |
> | | > NOTE |
> | | > |
> | | > *We may remove this or |
> | | > harmonize with other date time |
> | | > standards.* |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **date-start** | > Set the start date or the date |
> | | > of an event. |
> | | > |
> | | > NOTE |
> | | > |
> | | > *We may remove this or |
> | | > harmonize with other date time |
> | | > standards.* |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **email** | > E-mail address. |
> +-----------------------------------+-----------------------------------+
> | > **family-name** | > Family name (in some Western |
> | | > cultures, also known as the |
> | | > last name or surname). |
> +-----------------------------------+-----------------------------------+
> | > **fax** | > Full fax number, including |
> | | > international country code. |
> +-----------------------------------+-----------------------------------+
> | > **fax-area-code** | > Area code. |
> +-----------------------------------+-----------------------------------+
> | > **fax-country-code** | > International country code. |
> +-----------------------------------+-----------------------------------+
> | > **fax-local** | > Local fax number: full number |
> | | > minus country and area codes. |
> +-----------------------------------+-----------------------------------+
> | > **fax-national** | > National fax number: full |
> | | > number minus international |
> | | > country code and area code. |
> +-----------------------------------+-----------------------------------+
> | > **given-name** | > Given name (in some Western |
> | | > cultures, also known as the |
> | | > first name). |
> +-----------------------------------+-----------------------------------+
> | > **honorific-prefix** | > Prefix or title (e.g. \"Mr.\", |
> | | > \"Ms.\", \"Dr.\", \"Mlle\"). |
> +-----------------------------------+-----------------------------------+
> | > **honorific-suffix** | > Suffix (e.g. \"Jr.\", |
> | | > \"B.Sc.\", \"MBASW\", \"II\"). |
> +-----------------------------------+-----------------------------------+
> | > **impp** | > URL representing an instant |
> | | > messaging protocol endpoint |
> | | > (for example, |
> | | > \"aim:goim?screenname=example\" |
> | | > or \"xmpp:fred\@example.net"). |
> +-----------------------------------+-----------------------------------+
> | > **language** | > Ability to select the preferred |
> | | > language for the content. |
> +-----------------------------------+-----------------------------------+
> | > **name** | > Full name. |
> +-----------------------------------+-----------------------------------+
> | > **new-password** | > A new password (e.g., when |
> | | > creating an account or changing |
> | | > a password). |
> +-----------------------------------+-----------------------------------+
> | > **nickname** | > Nickname, screen name, handle: |
> | | > a typically short name used |
> | | > instead of the full name. |
> +-----------------------------------+-----------------------------------+
> | > **organization** | > Company name corresponding to |
> | | > the person, address, or contact |
> | | > information in the other fields |
> | | > associated with this field. |
> +-----------------------------------+-----------------------------------+
> | > **organization-title** | > Job title (e.g., \"Software |
> | | > Engineer\", \"Senior Vice |
> | | > President\", \"Deputy Managing |
> | | > Director"). |
> +-----------------------------------+-----------------------------------+
> | > **photo** | > Photo or avatar. |
> +-----------------------------------+-----------------------------------+
> | > **postal-code** | > Postal code, post code, ZIP |
> | | > code, CEDEX code (if CEDEX, |
> | | > append \"CEDEX\", and the |
> | | > arrondissement, if relevant, to |
> | | > the address-level2 field). |
> +-----------------------------------+-----------------------------------+
> | > **section-\*\*\*\*\*** | > Used to group forms together. |
> +-----------------------------------+-----------------------------------+
> | > **sex** | > Gender identity (e.g., Female, |
> | | > Fa'afafine). |
> +-----------------------------------+-----------------------------------+
> | > **subject** | > Form subject. Typically, a free |
> | | > text field. |
> +-----------------------------------+-----------------------------------+
> | > **tel** | > Full telephone number, |
> | | > including country code . |
> +-----------------------------------+-----------------------------------+
> | > **tel-area-code** | > Area code component of the |
> | | > telephone number, with a |
> | | > country-internal prefix applied |
> | | > if applicable. |
> +-----------------------------------+-----------------------------------+
> | > **tel-country-code** | > Country code component of the |
> | | > telephone number. |
> +-----------------------------------+-----------------------------------+
> | > **tel-extension** | > Telephone number internal |
> | | > extension code. |
> +-----------------------------------+-----------------------------------+
> | > **tel-local** | > Telephone number without the |
> | | > country code and area code |
> | | > components. |
> +-----------------------------------+-----------------------------------+
> | > **tel-local-prefix** | > First part of the component of |
> | | > the telephone number that |
> | | > follows the area code, when |
> | | > that component is split into |
> | | > two components. |
> +-----------------------------------+-----------------------------------+
> | > **tel-local-suffix** | > Second part of the component of |
> | | > the telephone number that |
> | | > follows the area code, when |
> | | > that component is split into |
> | | > two components. |
> +-----------------------------------+-----------------------------------+
> | > **tel-national** | > Telephone number without the |
> | | > county code component, with a |
> | | > country-internal prefix applied |
> | | > if applicable. |
> +-----------------------------------+-----------------------------------+
> | > **time-end** | > Set the end time of an event. |
> | | > |
> | | > NOTE |
> | | > |
> | | > *We may remove this or |
> | | > harmonize with other date time |
> | | > standards.* |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **time-start** | > Set the start time or the time |
> | | > of an event. |
> | | > |
> | | > NOTE |
> | | > |
> | | > *We may remove this or |
> | | > harmonize with other date time |
> | | > standards.* |
> | | > |
> | | > EDITOR\'S NOTE |
> | | > |
> | | > *At risk pending |
> | | > implementations.* |
> +-----------------------------------+-----------------------------------+
> | > **topic** | > Topic for the form. Typically, |
> | | > selected from a list of |
> | | > reserved words. |
> +-----------------------------------+-----------------------------------+
> | > **transaction-currency** | > The currency that the user |
> | | > would prefer the transaction to |
> | | > use. |
> +-----------------------------------+-----------------------------------+
> | > **transaction-amount** | > The amount that the user would |
> | | > like for the transaction (e.g. |
> | | > when entering a bid or sale |
> | | > price). |
> +-----------------------------------+-----------------------------------+
> | > **url** | > Home page or other Web page |
> | | > corresponding to the company, |
> | | > person, address, or contact |
> | | > information in the other fields |
> | | > associated with this field. |
> +-----------------------------------+-----------------------------------+
> | > **username** | > A username. |
> +-----------------------------------+-----------------------------------+
>
> > 3.4 simplification
> >
> > **3.4.1 Description**
> >
> > The simplification attribute differentiates between critical features
> > and less important features for simplification.
> >
> > This allows simplified interfaces with less options or interfaces that
> > emphasize critical features. Adaptations can be based on
> > personalization settings.
> >
> > EDITOR\'S NOTE
> >
> > This was formerly importance. However different people may feel that
> > sections that would be hidden in a simplified version are still very
> > important, such as marketing content or legal terms.)
> >
> > NOTE
> >
> > These semantics aid simplification. But what content is most useful to
> > a user varies from user to user. For example, men may be more
> > interested in men\'s clothing, and may not be interested in the more
> > frequently used women\'s clothing option. For that reason we may add
> > context for elements that will help the personalization agent select
> > the most useful content for a given user (see
> > the [[context]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#context) attribute).
> > This is also necessary for reminders (see below).
> >
> > It is worth mentioning that a lot of this information is known for
> > personalization of advertisements and content optimization.
> >
> > **3.4.2 Examples**
> >
> > Here is an example using the simplification attribute in the context
> > of a submit button.
> >
> > [[EXAMPLE 4]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-4-simplification-using-data): Simplification
> > using data-simplification
> >
> > \<**input** value=\"Submit\" type=\"submit\"
> > data-simplification=\"critical\"/\>
> >
> > In the example bellow the simplification attribute is used on critical
> > content a newsletter from an elementary school. Important
> > announcements about an early school dismissal is in a list of other
> > activities. If this important information is missed, the parents might
> > not be home in time, putting children at risk.
> >
> > [[EXAMPLE 5]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-5-simplification-using-data): Simplification
> > using data-simplification
> >
> > \<**p**\>Years 2 - 3 are putting on a play next week on Tuesday
> > \<**b** data-simplification=\"critical\"\>Therefore school will close
> > at 1 pm on Tuesday\</**b**\> so we can get the school hall
> > ready.\</**p**\>
> >
> > **3.4.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[SVG]{.underline}*](https://w |
> | | ww.w3.org/TR/SVG2/) \[[[SVG2]{.un |
> | | derline}](https://raw.githack.com |
> | | /w3c/personalization-semantics/ed |
> | | its07062020/content/index.html#bi |
> | | b-svg2)\] and [*[DOM]{.underline} |
> | | *](https://www.w3.org/TR/dom/) \[ |
> | | [[DOM4]{.underline}](https://raw. |
> | | githack.com/w3c/personalization-s |
> | | emantics/edits07062020/content/in |
> | | dex.html#bib-dom4)\] active |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[token]{.underline}](https://r |
> | | aw.githack.com/w3c/personalizatio |
> | | n-semantics/edits07062020/content |
> | | /index.html#valuetype_token) |
> +-----------------------------------+-----------------------------------+
>
> > **3.4.4 Values**
>
> +-----------------------------------+-----------------------------------+
> | **Value** | **Description** |
> +===================================+===================================+
> | **critical** | The critical setting should be |
> | | used on: |
> | | |
> | | - Controls and content that are |
> | | essential for the key |
> | | function (from the user |
> | | perspective) of the page. |
> | | Example: The send button for |
> | | an email draft in an email |
> | | application. |
> | | |
> | | - Controls and content that are |
> | | sometimes critical to use the |
> | | site, such as \"save my |
> | | work\" or \"emergency |
> | | instructions\". |
> | | |
> | | - Controls and content that are |
> | | used by over 90% of a user |
> | | group (such as parents or |
> | | teachers) most times they |
> | | interact with the content. |
> +-----------------------------------+-----------------------------------+
> | **medium (default)** | The medium setting should be used |
> | | on: |
> | | |
> | | - Controls and content that are |
> | | used frequently but are not |
> | | essential for the key |
> | | functioning of the |
> | | application. Example: The |
> | | delete button for an email |
> | | draft in an email |
> | | application. |
> | | |
> | | - Controls and content that are |
> | | sometimes important for a |
> | | user to interact with the |
> | | site, such as settings to |
> | | change colors or fonts. |
> | | |
> | | - Controls and content that are |
> | | used by over 60% of a user |
> | | group (such as parents or |
> | | teachers) when they interact |
> | | with the content. |
> +-----------------------------------+-----------------------------------+
> | **low** | The low setting should be used on |
> | | controls and content that are |
> | | rarely used or only used by |
> | | advanced users. Example: The |
> | | terms and services or the archive |
> | | button for an email application. |
> +-----------------------------------+-----------------------------------+
>
> > 3.5 distraction
> >
> > **3.5.1 Description**
> >
> > The distraction attribute should be used on non-essential detracting
> > content, so that people who have problems keeping focus can turn the
> > content off. An example user experiences would be to hide all
> > non-essential distracting content.
> >
> > Note that there is no default value.
> >
> > Note that elements with the distraction attribute should also have a
> > label or accessible name.
> >
> > **3.5.2 Examples**
> >
> > Example using the distraction attribute in the context of an animated
> > image.
> >
> > [[EXAMPLE 6]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-6-distraction-using-data): Distraction
> > using data-distraction
> >
> > \<**img** src=\"animated.gif\" alt=\"animated banner advertising for
> > Widgets\" data-distraction=\"sensory offer\"\>
> >
> > Example using the distraction attribute in the context of a stock
> > ticker that starts and displays upon page load. This example takes two
> > related terms, sensory and offer.
> >
> > [[EXAMPLE 7]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-7-distraction-using-data): Distraction
> > using data-distraction
> >
> > \<**div** data-distraction=\"sensory messages\"\> \... \</**div**\>
> >
> > Example of a count-down timer that starts at the user's request and
> > updates in real-time the hours, minutes, and seconds until an event.
> > This example takes two related terms, sensory and messages.
> >
> > [[EXAMPLE 8]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-8-distraction-using-data): Distraction
> > using data-distraction
> >
> > \<**div** data-distraction=\"sensory\"\> \... \</**div**\>
> >
> > **3.5.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[SVG]{.underline}*](https://w |
> | | ww.w3.org/TR/SVG2/) \[[[SVG2]{.un |
> | | derline}](https://raw.githack.com |
> | | /w3c/personalization-semantics/ed |
> | | its07062020/content/index.html#bi |
> | | b-svg2)\] and [*[DOM]{.underline} |
> | | *](https://www.w3.org/TR/dom/) \[ |
> | | [[DOM4]{.underline}](https://raw. |
> | | githack.com/w3c/personalization-s |
> | | emantics/edits07062020/content/in |
> | | dex.html#bib-dom4)\] active |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[token |
> | | > list]{.underline}](https://raw. |
> | | githack.com/w3c/personalization-s |
> | | emantics/edits07062020/content/in |
> | | dex.html#valuetype_token_list) |
> +-----------------------------------+-----------------------------------+
>
> > **3.5.4 Values**
>
> +-----------------------------------+-----------------------------------+
> | > **Value** | > **Description** |
> +===================================+===================================+
> | > **messages** | > Communication (auditory or |
> | | > visual) sent-to or left-for the |
> | | > user or the interface that |
> | | > allows interaction of |
> | | > text-based messages. Messages |
> | | > may also be automatically |
> | | > updating. Essential system |
> | | > messages should not be tagged |
> | | > as distractions. This includes |
> | | > but is not limited to WebRTC. |
> +-----------------------------------+-----------------------------------+
> | > **offer** | > An advertisement or offer for a |
> | | > product, feature or service, or |
> | | > content that is not essential |
> | | > to the user\'s current task. |
> +-----------------------------------+-----------------------------------+
> | > **overlay** | > Part of an application or |
> | | > content that is displayed over |
> | | > the top of the other content in |
> | | > a secondary window or popup, |
> | | > that blocks user interaction to |
> | | > the parent window. The content |
> | | > of the popup is not essential |
> | | > to the user's task and are not |
> | | > intentionally initiated by the |
> | | > user. |
> +-----------------------------------+-----------------------------------+
> | > **sensory** | > Non-essential distracting |
> | | > content that includes movement, |
> | | > sound or other forms of sensory |
> | | > feedback. This includes moving |
> | | > images (videos, animated GIFs, |
> | | > etc.); content that starts |
> | | > automatically or is |
> | | > automatically updating; and |
> | | > elements that change locations |
> | | > or generate audio feedback on |
> | | > the user\'s system. |
> +-----------------------------------+-----------------------------------+
>
> > 3.6 symbol
> >
> > **3.6.1 Description**
> >
> > The symbol attribute identifies the concept for symbols.
> >
> > The symbol attribute accepts a numeric reference number.
> >
> > A personalization agent can then load alternative symbols that the
> > user is familiar-with so they do not have to learn new symbols for
> > different applications.
> >
> > In some languages words and symbols are conjugated with sex or tense.
> > In these case more then one value maybe needed to map to a symbol.
> > Authors should join values that map to a single conjugated word with a
> > \\ + \\ sign with a space on each side of the \\+\\ sign. (User agent
> > may choose to accept values for a conjugated term that have been
> > separated without the spaces.) See [[best practices for symbol
> > values]{.underline}](https://github.com/w3c/personalization-semantics/wiki/Best-practices-for-symbol-values).
> >
> > When there is more than one concept that are not part of a single
> > conjugated term, multiple concepts can be referenced by separating
> > them with white space. The order of multiple concepts should be the
> > same as used in typical speech in the natural language of the content.
> >
> > EDITOR\'S NOTE
> >
> > For a list of current reference numbers please refer to
> > our [[data-symbol wiki
> > page]{.underline}](https://github.com/w3c/personalization-semantics/wiki/About-Data-Symbol).
> > The reference numbers are the same references numbers used in Bliss
> > (BCI numbers). Here is a link to the [[copyright licensing from
> > Bliss]{.underline}](http://www.blissymbolics.org/index.php/licensing).
> >
> > **3.6.2 Examples**
> >
> > Here are some examples using the symbol attribute.
> >
> > [[EXAMPLE 9]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-9-symbols-for-individual-words): Symbols
> > for individual words using data-symbol
> >
> > \<**span** data-symbol=\"13621\"\>Cup\</**span**\> \<**span**
> > data-symbol=\"12324\"\>of\</**span**\> \<**span**
> > data-symbol=\"17511\" \>Tea\</**span**\>
> >
> > You could also say
> >
> > [[EXAMPLE 10]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-10-list-of-symbols-for-a-text-phrase): List
> > of symbols for a text phrase using data-symbol
> >
> > \<**span** data-symbol=\"13621 12324 17511\"\>cup of Tea\</**span**\>
> >
> > or
> >
> > [[EXAMPLE 11]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-11-symbols-used-with-an-image): Symbols
> > used with an image using data-symbol
> >
> > \<**img** src=\"cuptea.png\" alt=\"cup of Tea\" data-symbol=\"13621
> > 12324 17511\" alt=\"cup of Tea\"/\>
> >
> > When there is more than one concept that are not part of a single
> > conjugated term, multiple concepts are referenced by separating them
> > with white space.
> >
> > [[EXAMPLE 12]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#example-12-symbols-with-conjugation): Symbols
> > with conjugation using data-symbol
> >
> > \<**img** src=\"her-name.png\" alt=\"שמה\" data-symbol=\"15691 +
> > 14707\"/\>
> >
> > In this example a symbol is used for \"her name\" for the conjugated
> > Hebrew word, שמה. The / + / is used to join the conjugated values,
> > \"her\" (14707) and \"name\" (15691). If the sex is not important you
> > can just use the value for name (15691).
> >
> > **3.6.3 Characteristics**
>
> +-----------------------------------+-----------------------------------+
> | > **Characteristic** | > **Value** |
> +===================================+===================================+
> | > **Related Concepts:** | > [*[microdata]{.underline}*](htt |
> | | ps://www.w3.org/TR/microdata/#the |
> | | -basic-syntax) \[[[microdata]{.un |
> | | derline}](https://raw.githack.com |
> | | /w3c/personalization-semantics/ed |
> | | its07062020/content/index.html#bi |
> | | b-microdata)\], [*[SKOS |
> | | > Core |
> | | > Guide]{.underline}*](http://www |
> | | .w3.org/TR/2005/WD-swbp-skos-core |
> | | -guide-20051102) \[[[SKOS |
> | | > Core |
> | | > Guide]{.underline}](https://raw |
> | | .githack.com/w3c/personalization- |
> | | semantics/edits07062020/content/i |
> | | ndex.html#bib-skos%20core%20guide |
> | | )\] and [[*RDFa \[*](https://www. |
> | | w3.org/TR/rdfa-primer/)[RDFa |
> | | > 1.1 |
> | | > Primer](https://raw.githack.com |
> | | /w3c/personalization-semantics/ed |
> | | its07062020/content/index.html#bi |
> | | b-rdfa%201.1%20primer)]{.underlin |
> | | e}*\]* |
> +-----------------------------------+-----------------------------------+
> | > **Used in Roles:** | > All elements of the base markup |
> +-----------------------------------+-----------------------------------+
> | > **Inherits into Roles:** | > Placeholder |
> +-----------------------------------+-----------------------------------+
> | > **Value:** | > [[URI]{.underline}](https://raw |
> | | .githack.com/w3c/personalization- |
> | | semantics/edits07062020/content/i |
> | | ndex.html#valuetype_uri) |
> +-----------------------------------+-----------------------------------+
>
> > 4. Privacy and Security Considerations
> >
> > This specification adds contextual information about content to the
> > document should not affect security.
> >
> > Although this specification does not expose personal preferences and
> > personal information, third party user agent or proxy server acting
> > upon this semantic information may need to store personal preferences
> > on how to present content to a specific user. We recommend any user
> > agent or proxy server implements best practices to protect all
> > personal preferences and personal information.
> >
> > Any user agent with user setting are recommended to follow best
> > practices to keep user information secure.
> >
> > The Privacy and Security Considerations of Personalization Semantics
> > Content Module is also discussed at [[issue
> > \#131]{.underline}](https://github.com/w3c/personalization-semantics/issues/131).
> >
> > A. Acknowledgments
> >
> > *This section is non-normative.*
> >
> > The following people contributed to the development of this document.
> >
> > A.1 Participants active in the Personalization TF at the time of
> > publication
>
> - Thaddeus Cambron (Invited Expert)
>
> - Michael Cooper (W3C/MIT)
>
> - John Foliot (Deque Systems, Inc.)
>
> - Becky Gibson (Knowbility, Inc.)
>
> - Charles LaPierre (Benetech)
>
> - Roy Ran (W3C/Beihang)
>
> - Lisa Seeman (Invited Expert)
>
> - Sharon Snider (IBM Corporation)
>
> > A.2 Other Personalization TF contributors, commenters, and previously
> > active participants
>
> - Joanmarie Diggs (Igalia)
>
> - Richard Schwerdtfeger (Knowbility, Inc.)
>
> - Jason White (Educational Testing Service)
>
> > A.3 Enabling funders
> >
> > This publication has been funded in part with U.S. Federal funds from
> > the Health and Human Services, National Institute on Disability,
> > Independent Living, and Rehabilitation Research (NIDILRR) under
> > contract number HHSP23301500054C. The content of this publication does
> > not necessarily reflect the views or policies of the U.S. Department
> > of Health and Human Services, nor does mention of trade names,
> > commercial products, or organizations imply endorsement by the U.S.
> > Government. Some of the work on this project has also received funding
> > from the European Union's Horizon 2020 research and innovation
> > programme under grant agreement No.780529 and 643399.
> >
> > B. References
> >
> > B.1 Informative references
> >
> > **\[DOM4\]**
> >
> > [*DOM Standard*](https://dom.spec.whatwg.org/). Anne van Kesteren.
> > WHATWG. Living Standard.
> > URL: [[https://dom.spec.whatwg.org/]{.underline}](https://dom.spec.whatwg.org/)
> >
> > **\[HTML5\]**
> >
> > [*HTML5*](https://www.w3.org/TR/html5/). Ian Hickson; Robin Berjon;
> > Steve Faulkner; Travis Leithead; Erika Doyle Navara; Theresa
> > O\'Connor; Silvia Pfeiffer. W3C. 27 March 2018. W3C Recommendation.
> > URL: [[https://www.w3.org/TR/html5/]{.underline}](https://www.w3.org/TR/html5/)
> >
> > **\[HTML52\]**
> >
> > [*HTML 5.2*](https://www.w3.org/TR/html52/). Steve Faulkner; Arron
> > Eicholz; Travis Leithead; Alex Danilo; Sangwhan Moon. W3C. 14 December
> > 2017. W3C Recommendation.
> > URL: [[https://www.w3.org/TR/html52/]{.underline}](https://www.w3.org/TR/html52/)
> >
> > **\[microdata\]**
> >
> > [*HTML Microdata*](https://www.w3.org/TR/microdata/). Charles
> > \'chaals\' (McCathie) Nevile; Dan Brickley; Ian Hickson. W3C. 26 April
> > 2018. W3C Working Draft.
> > URL: [[https://www.w3.org/TR/microdata/]{.underline}](https://www.w3.org/TR/microdata/)
> >
> > **\[personalization-semantics-1.0\]**
> >
> > [*Personalization Semantics Explainer
> > 1.0*](https://www.w3.org/TR/personalization-semantics-1.0/). Lisa
> > Seeman-Kestenbaum; Charles LaPierre; Michael Cooper; Ruoxi Ran;
> > Richard Schwerdtfeger. W3C. 11 July 2019. W3C Working Draft.
> > URL: [[https://www.w3.org/TR/personalization-semantics-1.0/]{.underline}](https://www.w3.org/TR/personalization-semantics-1.0/)
> >
> > **\[RDFa 1.1 Primer\]**
> >
> > *Reference not found.* *(RDFa 1.1 Primer - Third Edition* Ivan Herman,
> > Ben Adida, Manu Sporny, Mark Birbeck. W3C 17 March 2015
> > *https://www.w3.org/TR/rdfa-primer/)*
> >
> > **\[SKOS Core Guide\]**
> >
> > *Reference not found.* *(SKOS Core Guide* Alistair Miles, Dan
> > Brickley*.* W3C 2 November 2005
> > *https://www.w3.org/TR/swbp-skos-core-guide/)*
> >
> > **\[SVG2\]**
> >
> > [*Scalable Vector Graphics (SVG)
> > 2*](http://www.w3.org/TR/2015/WD-SVG2-20150915/). Nikos Andronikos;
> > Rossen Atanassov; Tavmjong Bah; Amelia Bellamy-Royds; Brian Birtles;
> > Cyril Concolato; Erik Dahlström; Chris Lilley; Cameron McCormack; Doug
> > Schepers; Dirk Schulze; Richard Schwerdtfeger; Satoru Takagi; Jonathan
> > Watt et al. W3C. W3C Working Draft.
> > URL: [[http://www.w3.org/TR/2015/WD-SVG2-20150915/]{.underline}](http://www.w3.org/TR/2015/WD-SVG2-20150915/)
> >
> > [[↑]{.underline}](https://raw.githack.com/w3c/personalization-semantics/edits07062020/content/index.html#title)
--
Janina Sajka
Linux Foundation Fellow
Executive Chair, Accessibility Workgroup: http://a11y.org
The World Wide Web Consortium (W3C), Web Accessibility Initiative (WAI)
Chair, Accessible Platform Architectures http://www.w3.org/wai/apa
Received on Monday, 15 June 2020 15:50:36 UTC