From beec811750b15258ef16873e6ea049d7c633d980 Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Tue, 4 Jun 2024 11:34:15 -0600 Subject: [PATCH 1/7] Added contact information with link to issue tracker --- dpub-aria-testing/content/DPUB-ARIA-tests.xhtml | 1 + 1 file changed, 1 insertion(+) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index eee3ad9..d544d43 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -6,6 +6,7 @@

DPUB ARIA Test Suite

Last updated: June 4, 2024

+

This test Suite has been created and is maintained by the DAISY Consortium's "Transition to Accessible EPUB" working group. To ask questions or get clarification, please use the issue tracker on GitHub.

Background

From 1154cb0a89f911f1b2b7fcb9729fe187c75e3007 Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Tue, 4 Jun 2024 12:39:30 -0600 Subject: [PATCH 2/7] Added guidance for all, some, most, nonn --- dpub-aria-testing/content/DPUB-ARIA-tests.xhtml | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index d544d43..870220f 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -10,19 +10,21 @@

Background

-

Books and other publications have constructs such as chapters, parts, footnotes and more that are not commonly found on web pages. The visual presentation of these constructs makes it obvious to the sighted reader what the semantics are. These semantic constructs can now be added to HTML and XHTML by using DPUB Aria roles and then used for presentation through Assistive Technology. The Publishing Community Group at the W3C continues to promote these roles for browsers, in EPUB Reading Systems, and for published digital materials.

-

To improve the reading experience for screen reader users, the presentation of these semantic constructs is recommended. Some of the roles are extremely important to present to the reader, while others are of less importance or a matter of reader preference. In this XHTML document, the Transition to Accessible EPUB working group in the DAISY Consortium is making suggestions as to the importance of the roles and what might be presented. This document provides the necessary information that screen reader implementors should consider. It can also be used for testing purposes.

+

Books and other publications have constructs such as chapters, parts, footnotes and more that are not commonly found on web pages. The visual presentation of these constructs makes it obvious to the sighted reader what the semantics are. These document semantic constructs can now be added to HTML and XHTML by using DPUB Aria roles and then used for presentation through Assistive Technology. The Publishing Community Group at the W3C continues to promote these roles for browsers, in EPUB Reading Systems, and for published digital materials.

+

To improve the reading experience for screen reader users, the presentation of these document semantic constructs is recommended. Some of the roles are extremely important to present to the reader, while others are of less importance or a matter of reader preference. In this XHTML document, the Transition to Accessible EPUB working group in the DAISY Consortium is making suggestions as to the importance of the roles and what might be presented. This document provides the necessary information that screen reader implementors should consider. It can also be used for testing purposes.

Each item should be self-explanatory and indicate the (1) importance and (2) what should be presented.

Screen Reader Implementation

There are currently 39 DPUB Aria roles which are prefixed with "doc-" before the name of the publishing construct, e.g. doc-chapter for a chapter. A list of the roles, their importance, suggested output, actions to be considered, and support in browsers can be found at: Google Sheet showing DPUB Aria roles and suggestions for implementors.

The following are presented for testing purposes. Included in the example is a description of the test, its importance, and suggested output, which corresponds to the Google sheet linked above.

-

Importance of vocalizing or presenting constructs:

+ +

The selection of the amount of document semantics to vocalize or present could be grouped as "all," "most", "some," or None."

+
-
critical
should always be presented
-
high
should be presented most of the time
-
medium
should be presented some of the time
-
low
should be presented with the highest verbosity setting
+
critical
should always be presented, unless "none" is selected.
+
high
should be presented when "most" is selected.
+
medium
should be presented when "some" is selected.
+
low
should be presented when "high" is selected.

Valid Aria Role Complementary Test

From d37446921c88094a96045c58c3815fd63efbb059 Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Tue, 4 Jun 2024 14:43:41 -0600 Subject: [PATCH 3/7] Made changes to all, some, most, non logic --- dpub-aria-testing/content/DPUB-ARIA-tests.xhtml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index 870220f..8b837ce 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -22,9 +22,9 @@
critical
should always be presented, unless "none" is selected.
-
high
should be presented when "most" is selected.
-
medium
should be presented when "some" is selected.
-
low
should be presented when "high" is selected.
+
high
should be presented when "some" "most," or "all"is selected.
+
medium
should be presented when "some" or "all" is selected.
+
low
should be presented when "all" is selected.

Valid Aria Role Complementary Test

From 2dd2f3faf31183a99af6dc7bb638776fc6c8894b Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Tue, 4 Jun 2024 15:43:13 -0600 Subject: [PATCH 4/7] Moved complementary to the end --- dpub-aria-testing/content/DPUB-ARIA-tests.xhtml | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index 8b837ce..f051f96 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -26,10 +26,7 @@
medium
should be presented when "some" or "all" is selected.
low
should be presented when "all" is selected.
-

Valid Aria Role Complementary Test

-
- This text in a div element has the role of complementary. -
+

doc-abstract Test

This text in the div element has the role of abstract.

This is a high priority. Many times the word "abstract" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high.

@@ -206,8 +203,17 @@

This is a critical priority. The vocalization of the information that it is a table of contents should always be vocalized.

Suggested output: "table of contents"

This is an "actionable item" meaning the user would want to have a mechanism to go to the table of contents.

-

doc-fake Test

+ +

Tests to make sure nothing is voiced

+ +

The next two tests should not be voiced through the DPUB ARIA roles. They are placed here only for testing purposes.

+ +

doc-fake Test

This text has the role of fake which should not map to anything other than generic.
+

Valid Aria Role Complementary Test

+
+ This text in a div element has the role of complementary. +
From 4db8bd7bacb82d0a920bb3eaabf458dd40ca3460 Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Wed, 5 Jun 2024 10:59:18 -0600 Subject: [PATCH 5/7] Fixed verbosity and acknowledgments --- .../content/DPUB-ARIA-tests.xhtml | 79 ++++++++++--------- 1 file changed, 40 insertions(+), 39 deletions(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index f051f96..01e7627 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -27,25 +27,26 @@
low
should be presented when "all" is selected.
+

Note: a verbosity selection of"some" includes critical and high importance. A verbosity selection of "most includes critical, high, and medium.

doc-abstract Test

This text in the div element has the role of abstract.
-

This is a high priority. Many times the word "abstract" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high.

+

This is a high priority. Many times the word "abstract" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

Suggested output: "abstract"

-

doc-acknowledgments Test

+

doc-acknowledgments Test

This text in the div element has the role of acknowledgments.
-

This is a low priority. Many times the word "Acknowledgements" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

-

Suggested output: "acknowledgements"

+

This is a low priority. Many times the word "Acknowledgements" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

+

Suggested output: "acknowledgments"

doc-afterword Test

This text in the div element has the role of afterword.
-

This is a medium priority. Many times the word "Afterword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "Afterword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

Suggested output: "afterword"

doc-appendix Test

This text in the div element has the role of appendix.
-

This is a medium priority. Many times the word "Appendix" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "Appendix" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

Suggested output: "appendix"

a backlink -

This is a critical priority. The vocalization of the information that it is a back link should always be vocalized.

+

This is a critical priority. The vocalization of the information that it is a back link should always be vocalized, unless none is selected.

Suggested output: "back link"

This is an "actionable item" meaning the user would follow the back link to return to the identified position in the publication.

doc-bibliography Test

@@ -58,40 +59,40 @@
This text in the div element has bibliography role. Test added to check if it acts differently from role on section tag.
-

This is a medium priority. Many times the word "bibliography" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "bibliography" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

Suggested output: "bibliography"

doc-biblioref Test

a role of biblioref. -

This is a critical priority. The vocalization of the information that it is a Bibliographic reference link should always be vocalized.

+

This is a critical priority. The vocalization of the information that it is a Bibliographic reference link should always be vocalized, unless none is selected.

Suggested output: "bibliographic reference"

This is an "actionable item" meaning the user would follow the link to go to the reference identified.

doc-chapter Test

This text has the role of chapter.
-

This is a high priority. Many times the word "chapter" will not appear in the heading. It should be vocalized when the verbosity is set to high.

+

This is a high priority. Many times the word "chapter" will not appear in the heading. It should be vocalized when the verbosity is set to some, most, or all.

Suggested output: "chapter"

doc-colophon Test

This text has the role of colophon.
-

This is a low priority. Many times the word "colophon" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

+

This is a low priority. Many times the word "colophon" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

Suggested output: "colophon"

doc-conclusion Test

This text has the role of conclusion.
-

This is a medium priority. Many times the word "conclusion" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "conclusion" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

Suggested output: "conclusion"

doc-cover Test

A beautiful cover with role of cover. -

This is a medium priority. Many times the word "Cover" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "Cover" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

Suggested output, "cover"

doc-credit Test

This text has the role of credit.
-

This is a low priority. Many times the word "credit" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

+

This is a low priority. Many times the word "credit" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

Suggested output: "credit"

doc-credits Test

This text has the role of credits.
-

This is a low priority. Many times the word "credits" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

+

This is a low priority. Many times the word "credits" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

Suggested output: "credits"

doc-dedication Test

This text has the role of dedication.
-

This is a medium priority. Many times the word "dedication" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

+

This is a medium priority. Many times the word "dedication" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

Suggested output: "dedication"

doc-endnotes Tests

@@ -101,106 +102,106 @@
  • list item inside endnotes
  • second list item inside endnotes
    • -

    This is a critical priority. Many times the word "end notes" would be included in the heading associated with this item. It should be vocalized all of the time.

    +

    This is a critical priority. Many times the word "end notes" would be included in the heading associated with this item. It should be vocalized all of the time, unless none is selected.

    Suggested output: "endnotes"

    This text in the div element has the endnotes role. Test added to check if it acts differently from role on section tag.

    doc-epigraph Test

    This text has the role of epigraph.
    -

    This is a low priority. Many times the word "epigraph" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

    +

    This is a low priority. Many times the word "epigraph" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    Suggested output: "epigraph"

    doc-epilogue Test

    This test has the role of epilogue.
    -

    This is a medium priority. Many times the word "epilogue" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "epilogue" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "epilogue"

    doc-errata Test

    This text has the role of errata.
    -

    This is a low priority. Many times the word "errata" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to low.

    +

    This is a low priority. Many times the word "errata" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    Suggested output: "errata"

    doc-example Test

    This text has the role of example.
    -

    This is a medium priority. Many times the word "example" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "example" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "example"

    doc-footnote Test

    This text has the role of footnote.
    -

    This is a critical priority. Many times the word "footnote" would be included in the heading associated with this item. It should always be vocalized.

    +

    This is a critical priority. Many times the word "footnote" would be included in the heading associated with this item. It should always be vocalized, unless none is selected.

    Suggested output: "footnote"

    doc-foreword Test

    This text has the role of foreword.
    -

    This is a medium priority. Many times the word "foreword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "foreword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "foreword"

    doc-glossary Test

    This text has the role of glossary. -

    This is a medium priority. Many times the word "glossary" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "glossary" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "glossary"

    foo role of term.: bar role of definition.

    doc-glossref Test

    a glossary reference -

    This is a critical priority. The vocalization of the information that it is a glossary reference link should always be vocalized.

    +

    This is a critical priority. The vocalization of the information that it is a glossary reference link should always be vocalized, unless none is selected.

    Suggested output: "glossary reference"

    This is an "actionable item" meaning the user would follow the link to go to the reference identified.

    doc-index Test

    This text has the role of index.
    -

    This is a medium priority. Many times the word "index" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "index" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

    Suggested output: "index"

    doc-introduction Test

    This text has the role of introduction.
    -

    This is a medium priority. Many times the word "introduction" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "introduction" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "introduction"

    doc-noteref Test

    a note reference -

    This is a critical priority. The vocalization of the information that it is a note reference link should always be vocalized.

    +

    This is a critical priority. The vocalization of the information that it is a note reference link should always be vocalized, unless none is selected.

    Suggested output: "note reference"

    This is an "actionable item" meaning the user would follow the link to go to the reference identified.

    doc-notice Test

    This text has the role of notice.

    This is a high priority. - the word "notice or caution" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high. + the word "notice or caution" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    Suggested output: "notice"

    doc-pagebreak Test

    In this text there is a pagebreak .

    -

    This is a critical priority. The vocalization of the information that it is a page break should always be vocalized.

    +

    This is a critical priority. The vocalization of the information that it is a page break should always be vocalized, unless none is selected.

    Suggested output: "page break"

    This is an "actionable item" meaning the user would want to go to the previous or next page break. This is an excellent candidate for single letter navigation and the letter p is suggested.

    doc-pagelist Test

    This text has the role of pagelist.
    -

    This is a critical priority. The vocalization of the information that it is a list of links to pages should always be vocalized.

    +

    This is a critical priority. The vocalization of the information that it is a list of links to pages should always be vocalized, unless none is selected.

    Suggested output: "list of pages"

    This is an "actionable item" meaning the user would want to be taken to the list of pages or if they were presented with a list of pages, it would be announced.

    doc-part Test

    This text has the role of part.
    -

    This is a high priority. Many times the word "part" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high.

    +

    This is a high priority. Many times the word "part" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most, some, or all .

    Suggested output: "part"

    doc-preface Test

    This text has the role of preface.
    -

    This is a medium priority. Many times the word "preface" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "preface" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "preface"

    doc-prologue Test

    This text has the role of prologue.
    -

    This is a medium priority. Many times the word "prolog" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to medium.

    +

    This is a medium priority. Many times the word "prolog" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    Suggested output: "prolog"

    doc-pullquote Test

    This text has the role of pullquote.
    -

    This is a high priority. Many times emphasized portions of text are in a margin or pulled to the side. The information that emphasized text is being presented should be vocalized when the verbosity is set to high.

    +

    This is a high priority. Many times emphasized portions of text are in a margin or pulled to the side. The information that emphasized text is being presented should be vocalized when the verbosity is set to some, most, or all.

    Suggested output: "emphasized text"

    doc-qna Test

    This text has the role of qna.
    -

    This is a high priority. Many times the words "Questions and Answers" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high.

    +

    This is a high priority. Many times the words "Questions and Answers" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    Suggested output: "questions and answers"

    doc-subtitle Test

    This text has the role of subtitle.
    -

    This is a high priority. Many times the subtitle is present after the title. It should be vocalized when the verbosity is set to high.

    +

    This is a high priority. Many times the subtitle is present after the title. It should be vocalized when the verbosity is set to some, most, or all.

    Suggested output: "subtitle"

    doc-tip Test

    This text has the role of tip.
    -

    This is a high priority. Many times the word "tip" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to high.

    +

    This is a high priority. Many times the word "tip" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    Suggested output: "tip"

    doc-toc Test

    This text has the role of toc.
    -

    This is a critical priority. The vocalization of the information that it is a table of contents should always be vocalized.

    +

    This is a critical priority. The vocalization of the information that it is a table of contents should always be vocalized, unless none is selected.

    Suggested output: "table of contents"

    This is an "actionable item" meaning the user would want to have a mechanism to go to the table of contents.

    From e7596a91d85d173b5448b974944605d5ebd8fc8a Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Wed, 5 Jun 2024 11:08:10 -0600 Subject: [PATCH 6/7] One minor correction --- dpub-aria-testing/content/DPUB-ARIA-tests.xhtml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index 01e7627..bae375b 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -23,7 +23,7 @@
    critical
    should always be presented, unless "none" is selected.
    high
    should be presented when "some" "most," or "all"is selected.
    -
    medium
    should be presented when "some" or "all" is selected.
    +
    medium
    should be presented when "most" or "all" is selected.
    low
    should be presented when "all" is selected.
    From a39b7378b4bc5f7a86d531e3f8f6e3d2d9d4c974 Mon Sep 17 00:00:00 2001 From: George Kerscher Date: Sat, 8 Jun 2024 13:09:01 -0600 Subject: [PATCH 7/7] Established document semantic verbosity as a term fixed space problems removed p as shortcut --- .../content/DPUB-ARIA-tests.xhtml | 92 +++++++++---------- 1 file changed, 46 insertions(+), 46 deletions(-) diff --git a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml index bae375b..13535fd 100644 --- a/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml +++ b/dpub-aria-testing/content/DPUB-ARIA-tests.xhtml @@ -5,12 +5,12 @@

    DPUB ARIA Test Suite

    -

    Last updated: June 4, 2024

    +

    Last updated: June 8, 2024

    This test Suite has been created and is maintained by the DAISY Consortium's "Transition to Accessible EPUB" working group. To ask questions or get clarification, please use the issue tracker on GitHub.

    Background

    -

    Books and other publications have constructs such as chapters, parts, footnotes and more that are not commonly found on web pages. The visual presentation of these constructs makes it obvious to the sighted reader what the semantics are. These document semantic constructs can now be added to HTML and XHTML by using DPUB Aria roles and then used for presentation through Assistive Technology. The Publishing Community Group at the W3C continues to promote these roles for browsers, in EPUB Reading Systems, and for published digital materials.

    +

    Books and other publications have constructs such as chapters, parts, footnotes and more that are not commonly found on web pages. The visual presentation of these constructs makes it obvious to the sighted reader what the document semantics are. These document semantic constructs can now be added to HTML and XHTML by using DPUB Aria roles and then used for presentation through Assistive Technology. The Publishing Community Group at the W3C continues to promote these roles for browsers, in EPUB Reading Systems, and for published digital materials.

    To improve the reading experience for screen reader users, the presentation of these document semantic constructs is recommended. Some of the roles are extremely important to present to the reader, while others are of less importance or a matter of reader preference. In this XHTML document, the Transition to Accessible EPUB working group in the DAISY Consortium is making suggestions as to the importance of the roles and what might be presented. This document provides the necessary information that screen reader implementors should consider. It can also be used for testing purposes.

    Each item should be self-explanatory and indicate the (1) importance and (2) what should be presented.

    Screen Reader Implementation

    @@ -18,35 +18,35 @@

    The following are presented for testing purposes. Included in the example is a description of the test, its importance, and suggested output, which corresponds to the Google sheet linked above.

    -

    The selection of the amount of document semantics to vocalize or present could be grouped as "all," "most", "some," or None."

    +

    The document semantic verbosity i.e., selection of the amount of document semantics to vocalize or present, could be grouped as "all," "most", "some," or None."

    -
    critical
    should always be presented, unless "none" is selected.
    -
    high
    should be presented when "some" "most," or "all"is selected.
    -
    medium
    should be presented when "most" or "all" is selected.
    -
    low
    should be presented when "all" is selected.
    +
    critical
    should always be presented, unless the document semantic verbosity "none" is selected.
    +
    high
    should be presented when the document semantic verbosity "some," "most," or "all"is selected.
    +
    medium
    should be presented when the document semantic verbosity "most" or "all" is selected.
    +
    low
    should be presented when the document semantic verbosity "all" is selected.
    -

    Note: a verbosity selection of"some" includes critical and high importance. A verbosity selection of "most includes critical, high, and medium.

    +

    Note: a document semantic verbosity selection of "some" includes critical and high importance. A verbosity selection of "most includes critical, high, and medium.

    doc-abstract Test

    This text in the div element has the role of abstract.
    -

    This is a high priority. Many times the word "abstract" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times the word "abstract" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "abstract"

    doc-acknowledgments Test

    This text in the div element has the role of acknowledgments.
    -

    This is a low priority. Many times the word "Acknowledgements" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "Acknowledgements" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "acknowledgments"

    doc-afterword Test

    This text in the div element has the role of afterword.
    -

    This is a medium priority. Many times the word "Afterword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

    +

    This is a medium priority. Many times the word "Afterword" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to Most or all.

    Suggested output: "afterword"

    doc-appendix Test

    This text in the div element has the role of appendix.
    -

    This is a medium priority. Many times the word "Appendix" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "Appendix" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "appendix"

    a backlink -

    This is a critical priority. The vocalization of the information that it is a back link should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a back link should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "back link"

    This is an "actionable item" meaning the user would follow the back link to return to the identified position in the publication.

    doc-bibliography Test

    @@ -59,40 +59,40 @@
    This text in the div element has bibliography role. Test added to check if it acts differently from role on section tag.
    -

    This is a medium priority. Many times the word "bibliography" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

    +

    This is a medium priority. Many times the word "bibliography" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to Most or all.

    Suggested output: "bibliography"

    doc-biblioref Test

    a role of biblioref. -

    This is a critical priority. The vocalization of the information that it is a Bibliographic reference link should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a Bibliographic reference link should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "bibliographic reference"

    This is an "actionable item" meaning the user would follow the link to go to the reference identified.

    doc-chapter Test

    This text has the role of chapter.
    -

    This is a high priority. Many times the word "chapter" will not appear in the heading. It should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times the word "chapter" will not appear in the heading. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "chapter"

    doc-colophon Test

    This text has the role of colophon.
    -

    This is a low priority. Many times the word "colophon" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "colophon" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "colophon"

    doc-conclusion Test

    This text has the role of conclusion.
    -

    This is a medium priority. Many times the word "conclusion" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "conclusion" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "conclusion"

    doc-cover Test

    A beautiful cover with role of cover. -

    This is a medium priority. Many times the word "Cover" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "Cover" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output, "cover"

    doc-credit Test

    This text has the role of credit.
    -

    This is a low priority. Many times the word "credit" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "credit" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "credit"

    doc-credits Test

    This text has the role of credits.
    -

    This is a low priority. Many times the word "credits" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "credits" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "credits"

    doc-dedication Test

    This text has the role of dedication.
    -

    This is a medium priority. Many times the word "dedication" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "dedication" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "dedication"

    doc-endnotes Tests

    @@ -102,106 +102,106 @@
  • list item inside endnotes
  • second list item inside endnotes
    • -

    This is a critical priority. Many times the word "end notes" would be included in the heading associated with this item. It should be vocalized all of the time, unless none is selected.

    +

    This is a critical priority. Many times the word "end notes" would be included in the heading associated with this item. It should be vocalized all of the time, unless the document semantic verbosity of none is selected.

    Suggested output: "endnotes"

    This text in the div element has the endnotes role. Test added to check if it acts differently from role on section tag.

    doc-epigraph Test

    This text has the role of epigraph.
    -

    This is a low priority. Many times the word "epigraph" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "epigraph" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "epigraph"

    doc-epilogue Test

    This test has the role of epilogue.
    -

    This is a medium priority. Many times the word "epilogue" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "epilogue" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "epilogue"

    doc-errata Test

    This text has the role of errata.
    -

    This is a low priority. Many times the word "errata" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to all.

    +

    This is a low priority. Many times the word "errata" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to all.

    Suggested output: "errata"

    doc-example Test

    This text has the role of example.
    -

    This is a medium priority. Many times the word "example" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "example" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "example"

    doc-footnote Test

    This text has the role of footnote.
    -

    This is a critical priority. Many times the word "footnote" would be included in the heading associated with this item. It should always be vocalized, unless none is selected.

    +

    This is a critical priority. Many times the word "footnote" would be included in the heading associated with this item. It should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "footnote"

    doc-foreword Test

    This text has the role of foreword.
    -

    This is a medium priority. Many times the word "foreword" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "foreword" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "foreword"

    doc-glossary Test

    This text has the role of glossary. -

    This is a medium priority. Many times the word "glossary" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "glossary" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "glossary"

    foo role of term.: bar role of definition.

    doc-glossref Test

    a glossary reference -

    This is a critical priority. The vocalization of the information that it is a glossary reference link should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a glossary reference link should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "glossary reference"

    This is an "actionable item" meaning the user would follow the link to go to the reference identified.

    doc-index Test

    This text has the role of index.
    -

    This is a medium priority. Many times the word "index" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to Most or all.

    +

    This is a medium priority. Many times the word "index" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to Most or all.

    Suggested output: "index"

    doc-introduction Test

    This text has the role of introduction.
    -

    This is a medium priority. Many times the word "introduction" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "introduction" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "introduction"

    doc-noteref Test

    a note reference -

    This is a critical priority. The vocalization of the information that it is a note reference link should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a note reference link should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "note reference"

    This is an "actionable item" meaning the user would follow the link to go to the reference identified.

    doc-notice Test

    This text has the role of notice.

    This is a high priority. - the word "notice or caution" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all. + the word "notice or caution" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "notice"

    doc-pagebreak Test

    In this text there is a pagebreak .

    -

    This is a critical priority. The vocalization of the information that it is a page break should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a page break should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "page break"

    -

    This is an "actionable item" meaning the user would want to go to the previous or next page break. This is an excellent candidate for single letter navigation and the letter p is suggested.

    +

    This is an "actionable item" meaning the user would want to go to the previous or next page break. This is an excellent candidate for single letter navigation .

    doc-pagelist Test

    This text has the role of pagelist.
    -

    This is a critical priority. The vocalization of the information that it is a list of links to pages should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a list of links to pages should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "list of pages"

    This is an "actionable item" meaning the user would want to be taken to the list of pages or if they were presented with a list of pages, it would be announced.

    doc-part Test

    This text has the role of part.
    -

    This is a high priority. Many times the word "part" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most, some, or all .

    +

    This is a high priority. Many times the word "part" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most, some, or all .

    Suggested output: "part"

    doc-preface Test

    This text has the role of preface.
    -

    This is a medium priority. Many times the word "preface" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "preface" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "preface"

    doc-prologue Test

    This text has the role of prologue.
    -

    This is a medium priority. Many times the word "prolog" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to most or all.

    +

    This is a medium priority. Many times the word "prolog" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to most or all.

    Suggested output: "prolog"

    doc-pullquote Test

    This text has the role of pullquote.
    -

    This is a high priority. Many times emphasized portions of text are in a margin or pulled to the side. The information that emphasized text is being presented should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times emphasized portions of text are in a margin or pulled to the side. The information that emphasized text is being presented should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "emphasized text"

    doc-qna Test

    This text has the role of qna.
    -

    This is a high priority. Many times the words "Questions and Answers" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times the words "Questions and Answers" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "questions and answers"

    doc-subtitle Test

    This text has the role of subtitle.
    -

    This is a high priority. Many times the subtitle is present after the title. It should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times the subtitle is present after the title. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "subtitle"

    doc-tip Test

    This text has the role of tip.
    -

    This is a high priority. Many times the word "tip" would be included in the heading associated with this item. It should be vocalized when the verbosity is set to some, most, or all.

    +

    This is a high priority. Many times the word "tip" would be included in the heading associated with this item. It should be vocalized when the document semantic verbosity is set to some, most, or all.

    Suggested output: "tip"

    doc-toc Test

    This text has the role of toc.
    -

    This is a critical priority. The vocalization of the information that it is a table of contents should always be vocalized, unless none is selected.

    +

    This is a critical priority. The vocalization of the information that it is a table of contents should always be vocalized, unless the document semantic verbosity of none is selected.

    Suggested output: "table of contents"

    This is an "actionable item" meaning the user would want to have a mechanism to go to the table of contents.