Ace SMART — User Guide

Discovery Metadata

After completing the accessibility evaluation, the next step is to review the discovery metadata in the Discovery Metadata tab.

Each of the fields in this tab corresponds to a schema.org accessibility metadata property. The fields are pre-populated, whenever possible, from information in the Ace JSON report, but should always be verified for accuracy (some metadata may be inferred, as noted in the Ace report loading step).

There are seven discovery properties:

Accessibility Features

This field describes any features or affordances included in the publication that improve its accessibility for readers with different preferred modalities.

Accessibility feature checkboxes

Additional features can be added by clicking the "Add custom field" link. Be sure to follow the naming convention for accessibility metadata when adding new features (the human-readable names used in the SMART tool are only a convenience; they are not the values used in the output metadata).

More information about accessibility features is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Accessibility Summary

Use this field to include a short description of the overall accessibility of the publication, or of its failings.

Accessibility summary text box

More information about accessibility summaries is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Accessibility Hazard

This field identifies any potential hazards in the content, such as a seizure risk from flashing content.

Accessibility hazard checkboxes

More information about accessibility hazards is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Access Modes

Identifies the perceptual systems or cognitive faculties the reader requires to perceive the content. For exmaple, visual is checked if there are images or video, textual if there is text content, auditory if there is audio, etc.

Access mode checkboxes

More information about access modes is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Sufficient Access Modes

Identifies one or more sets of access modes through which a reader can understand the full content of the publication.

Unlike the list of access modes, which only accounts for the default nature of the content, sufficient access modes take into account any features or affordances that allow the original content to be consumed in an alternative form. A publication with text and images, for example, may have a purely textual sufficient access mode if text equivalents and descriptions are provided for all visual content.

Sufficient access modes checkboxes

Authors can always include at least one sufficient access mode set that matches all of the listed access modes.

More information about sufficient access modes is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Accessibility API

If the publication uses ARIA roles, states and properties to make all custom controls accessible, check this field.

Accessibility API checkboxes

More information about accessibility APIs is available from the Web Schemas wiki and the EPUB Accessibility techniques.

Accessibility Control

This field identifies input methods that can be used to control the content. It is typically only necessary to specify controls if there is scripted content in the publication, as the ability to control the reading of the publication within any reading system is outside the control of the author.

Accessibility control checkboxes

More information about accessibility input controls is available from the Web Schemas wiki and the EPUB Accessibility techniques.

If the publication did not contain discovery metadata, or if you made changes to what was found, click the "Generate" button at the bottom of the tab to create a new set of metadata tags.

Generate button

Metadata compatible with the EPUB version you specified when setting the publication information will be generated and made available to copy and paste from a new dialog box.

The discovery metadata dialog box overlays
						the current screen when opened; it contains the metadata inside a textbox and there is a close button.

If any validation errors are encountered, an alert dialog will first appear asking you if you wish to continue or exit and check the problems. Errors are listed in the message panel that opens at the bottom of the page.

Note: It is recommended you include discovery metadata even if the publication fails conformance testing. It is a required component of the EPUB Accessibility specification.