Fix definition respec issues

README.md

@@ -129,6 +129,8 @@ Represents each `dt`/`dd` pair appearing in the Glossary section.
 - `synonyms` - Optional list of other words or phrases that can be used to reference this term
   - This does **not** need to include plurals where the final word ends in "s" or "es";
     this is automatically supported
+- `unusedDefinition` - Boolean flag; if true,
+  [suppresses ReSpec's unused definition warning](https://respec.org/docs/#lint-ignore) for this term
 
 **Note:** If a term file is empty, a "to be defined" Editor's Note will be inserted.
 

guidelines/groups/consistency-across-views/consistency/consistent-navigation-order.md

@@ -6,7 +6,7 @@ status: developing
 The relative order of navigation items is consistent within blocks of navigation that are repeated on multiple pages/views of the product or process.
 
 :::applies-when
-- In a :term[set of pages/views]
+- In a set of :term[pages]/:term[views]
 :::
 
 :::ednote

guidelines/groups/consistency-across-views/consistency/consistent-structural-order.md

@@ -6,7 +6,7 @@ status: developing
 The relative order of :term[structural components] remains consistent throughout each specific :term[variation of product or process].
 
 :::applies-when
-- In a :term[set of pages/views]
+- In a set of :term[pages]/:term[views]
 :::
 
 :::note

guidelines/groups/images-and-media/captions/captions-synchronized.md

@@ -3,7 +3,7 @@ type: foundational
 status: developing
 ---
 
-:term[Captions] are synchronized with the :term[audio] :term[content] of synchronized media.
+:term[Captions] are synchronized with the :term[audio] :term[content] of :term[synchronized media].
 
 :::tests
 <b>Procedure</b>

guidelines/groups/images-and-media/single-sense/spatial-audio-not-relied-on.md

@@ -3,7 +3,7 @@ status: developing
 type: foundational
 ---
 
-Information is not conveyed by spatial audio alone.
+Information is not conveyed by :term[spatial audio] alone.
 
 :::note
 Information conveyed includes presenting data or meaning, indicating an action, prompting a response, distinguishing between items, conveying boundaries, etc. Artistic expression is not part of information conveyed.

guidelines/groups/input-operation/authentication/biometrics-not-relied-on.md

@@ -3,7 +3,7 @@ status: developing
 type: foundational
 ---
 
-Biometric identification is not the only way to identify or authenticate.
+:term[Biometric] identification is not the only way to identify or authenticate.
 
 :::note
 Biometrics includes facial recognition software, fingerprinting, vocal patterns and other voice characteristics.

guidelines/groups/input-operation/authentication/multiple-biometrics-available.md

@@ -3,7 +3,7 @@ type: foundational
 status: developing
 ---
 
-Authentication does not rely solely on a single type of biometric information.
+Authentication does not rely solely on a single type of :term[biometrics].
 
 :::ednote
 Methods & best practices

guidelines/groups/input-operation/pointer-input/simple-pointer-input-available.md

@@ -20,7 +20,7 @@ Complex pointer inputs are not banned, but they cannot be the only way to accomp
 :::
 
 :::note
-Simple pointer input is different than :term[single pointer input] and is more restrictive than simply using a :term[single pointer].
+Simple pointer input is different than :term[single pointer input] and is more restrictive than simply using a single pointer.
 :::
 
 :::tests

guidelines/groups/interactive-components/control-information/roles-values-states-properties-available.md

@@ -4,7 +4,7 @@ title: Roles, values, states, properties available
 type: foundational
 ---
 
-Accurate names, roles, values, and states are available for :term[interactive elements].
+Accurate names, roles, values, and :term[states] are available for :term[interactive elements].
 
 :::ednote
 Methods & best practices
@@ -21,4 +21,4 @@ For each interactive element:
 
 **Expected results**
 - #1 is true.
-:::
+:::

guidelines/groups/interactive-components/keyboard-focus-appearance/default-focus-indicator-used.md

@@ -3,7 +3,7 @@ status: developing
 type: foundational
 ---
 
-The focusable :term[item] uses the :term[user agent] default focus indicator.
+The focusable :term[item] uses the :term[user agent] default :term[focus indicator].
 
 :::tests
 **Procedure**

guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-contrast-sufficient.md

@@ -3,7 +3,7 @@ status: developing
 type: supplemental
 ---
 
-If a custom focus indicator is used, it has sufficient adjacent contrast and change of contrast.
+If a custom :term[focus indicator] is used, it has sufficient adjacent contrast and change of contrast.
 
 :::applies-when
 * the user agent's default focus indicator is replaced by a custom focus indicator.

guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-size-sufficient.md

@@ -3,7 +3,7 @@ status: developing
 type: supplemental
 ---
 
-If a custom focus indicator is used, it has sufficient size and adjacency.
+If a custom :term[focus indicator] is used, it has sufficient size and adjacency.
 
 :::applies-when
 * the user agent's default focus indicator is replaced by a custom focus indicator.

guidelines/groups/layout/user-orientation/page-view-title-available.md

@@ -4,7 +4,7 @@ type: foundational
 status: developing
 ---
 
-Pages/views have a :term[title] that describes the name, topic or purpose.
+:term[Pages]/:term[views] have a title that describes the name, topic or purpose.
 
 :::except-when
 - The presented content has no way to include a title.

guidelines/groups/text-and-wording/clear-language/common-words-used.md

@@ -7,7 +7,7 @@ type: supplemental
 Common words are used, and definitions are available for uncommon words. 
 
 :::applies-when
-* human languages have more than 1,500 words
+* :term[human languages] have more than 1,500 words
 :::
 
 :::except-when

guidelines/groups/text-and-wording/clear-language/diacritics-available.md

@@ -3,10 +3,10 @@ status: developing
 type: supplemental
 ---
 
-Diacritics required to identify the correct meaning of each word are available.
+:term[Diacritics] required to identify the correct meaning of each word are available.
 
 :::applies-when 
-* a human language has a version that removes diacritics for proficient readers.
+* a :term[human language] has a version that removes diacritics for proficient readers.
 :::
 
 :::note

guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-enhanced.md

@@ -5,7 +5,7 @@ type: supplemental
 title: Text contrast sufficient (enhanced)
 ---
 
-The default visual presentation of text meets @@[X contrast measure, at a higher level than the core requirement for Text contrast sufficient (minimum)].
+The :term[default visual presentation] of text meets @@[X contrast measure, at a higher level than the core requirement for Text contrast sufficient (minimum)].
 
 :::ednote
 The contrast algorithm used in WCAG 3 is yet to be determined. For this draft, the requirement assumes the algorithm will include a size/weight factor. If the algorithm does not include size/weight, it will need to be added to this requirement text.

guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-minimum.md

@@ -5,7 +5,7 @@ type: foundational
 title: Text contrast sufficient (minimum)
 ---
 
-The default visual presentation of text meets @@[X contrast measure, to be determined].
+The:term[default visual presentation] of text meets @@[X contrast measure, to be determined].
 
 :::applies-when
 * text is presented, including text embedded in an image format.

guidelines/groups/text-and-wording/text-to-speech.md

@@ -7,4 +7,4 @@ children:
 title: Text-to-speech
 ---
 
-Users can access :term[text content] and its meaning with :term[text-to-speech] tools.
+Users can access :term[text content] and its meaning with text-to-speech tools.

guidelines/groups/text-and-wording/text-to-speech/human-language-detectable.md

@@ -3,7 +3,7 @@ status: developing
 type: foundational
 ---
 
-The human language of all :term[content] within the :term[view] is :term[programmatically determinable].
+The :term[human language] of all :term[content] within the :term[view] is :term[programmatically determinable].
 
 :::except-when
 * a language tag is not available in ISO 639 language codes, or

guidelines/terms/color-contrast.md

@@ -1,5 +1,6 @@
 ---
 status: developing
+unusedDefinition: true
 ---
 
 relationship of hue, saturation, and lightness values between two colors

guidelines/terms/complex-pointer-input.md

@@ -4,7 +4,7 @@ synonyms:
   - complex pointer inputs
 ---
 
-any pointer input other than a :term[single pointer] input
+any pointer input other than a :term[single pointer input]
 
 :::example
 - Double clicking

guidelines/terms/css-pixels.md → guidelines/terms/css-pixel.md

@@ -6,4 +6,4 @@ visual angle of about 0.0213 degrees
 
 :::note
 A CSS pixel is the canonical unit of measure for all lengths and measurements in CSS. This unit is density-independent, and distinct from actual hardware pixels present in a display. User agents and operating systems should ensure that a CSS pixel is set as closely as possible to the CSS Values and Units Module Level 3 reference pixel [css3-values], which takes into account the physical dimensions of the display and the assumed viewing distance (factors that cannot be determined by content authors).
-:::
+:::

guidelines/terms/essential-exception.md

@@ -1,5 +1,6 @@
 ---
 status: developing
+unusedDefinition: true
 ---
 
 exception because there is no way to carry out the function without doing it this way or fundamentally changing the functionality

guidelines/terms/figure-captions.md → guidelines/terms/figure-caption.md

@@ -2,4 +2,4 @@
 status: developing
 ---
 
-title, brief explanation, or comment that accompanies a work of visual media and is always visible on the page
+title, brief explanation, or comment that accompanies a work of visual media and is always visible on the page

guidelines/terms/human-language.md

@@ -0,0 +1,9 @@
+---
+status: exploratory
+---
+
+language that is spoken, written, or signed (through visual or tactile means) to communicate with humans
+
+:::note
+See also :term[sign language].
+:::

guidelines/terms/image-role.md

@@ -1,5 +1,4 @@
 ---
 status: placeholder
-synonyms:
-  - role
+unusedDefinition: true
 ---

guidelines/terms/infinite-scrolling.md

@@ -0,0 +1,3 @@
+---
+status: placeholder
+---

guidelines/terms/meaningful-blocks-of-content.md

@@ -0,0 +1,3 @@
+---
+status: placeholder
+---

guidelines/terms/minimum-bounding-box.md

@@ -1,5 +1,6 @@
 ---
 status: developing
+unusedDefinition: true
 ---
 
 the smallest enclosing rectangle aligned to the horizontal axis within which all the points of a shape lie

guidelines/terms/non-decorative-image.md

@@ -0,0 +1,4 @@
+---
+status: placeholder
+title: non-decorative image
+---

guidelines/terms/non-text-content.md

@@ -3,7 +3,7 @@ status: exploratory
 title: non-text content
 ---
 
-any content that is not a sequence of characters that can be :term[programmatically determinable] or where the sequence is not expressing something in :[human language]
+any content that is not a sequence of characters that can be :term[programmatically determinable] or where the sequence is not expressing something in :term[human language]
 
 :::note
 This includes :term[ASCII art] (which is a pattern of characters), emoticons, leetspeak (which uses character substitution), and images representing text

guidelines/terms/platform.md

@@ -2,7 +2,7 @@
 status: developing
 ---
 
-software, or collection of layers of software, that lie below the subject software and provide services to the subject software and that allows the subject software to be isolated from the hardware, drivers, and other software below
+software, or collection of layers of software, that lies below the subject software and provides services to the subject software and that allows the subject software to be isolated from the hardware, drivers, and other software below
 
 :::note
 Platform software both makes it easier for subject software to run on different hardware, and provides the subject software with many services (e.g. functions, utilities, libraries) that make the subject software easier to write, keep updated, and work more uniformly with other subject software.
@@ -17,7 +17,7 @@ The platform is the context in which the :term[product] exists.
 :::
 
 :::example
-* A web-browser is a platform as it provides software services to HTML, CSS, and JavaScript based software.
+* A web browser is a platform as it provides software services to HTML, CSS, and JavaScript based software.
 * An operating system provides software services to applications designed to run on that platform.
 * An e-reader is a platform that provides software services to e-books.
 :::

guidelines/terms/presentation.md

@@ -1,5 +1,6 @@
 ---
 status: developing
+unusedDefinition: true
 ---
 
 rendering of the :term[content] in a form to be perceived by users

guidelines/terms/private-and-sensitive-information.md

@@ -1,5 +1,6 @@
 ---
 status: exploratory
+unusedDefinition: true
 ---
 
 private and sensitive information
@@ -9,7 +10,7 @@ Such as, but not limited to:
 
 * Racial or ethnic origin
 * Personally identifiable information
-* Biometric information
+* :term[Biometrics]
 * Medical and health information
 * Gender identification
 * Financial information

guidelines/terms/product.md

@@ -2,7 +2,7 @@
 status: developing
 ---
 
-testing scope that is a combination of all :term[items], :term[views], and :term[task flows] that make up the web site, set of web pages, web app, etc.
+testing scope that is a combination of all :term[items], :term[views], and :term[task flows] that make up the website, set of web pages, web app, etc.
 
 :::note
 The context for the product would be the :term[platform].

guidelines/terms/relationship-of-meaning.md

@@ -0,0 +1,5 @@
+---
+status: placeholder
+synonyms:
+  - relationships of meaning
+---

guidelines/terms/rendered-content.md

@@ -0,0 +1,3 @@
+---
+status: placeholder
+---

guidelines/terms/semi-automated-evaluation.md

@@ -1,6 +1,6 @@
 ---
 status: developing
-title: Semi-automated evaluation
+title: semi-automated evaluation
 ---
 
 :term[evaluation] conducted using machines to guide humans to areas that need inspection

guidelines/terms/single-pointer-input.md

@@ -1,10 +1,8 @@
 ---
 status: developing
-synonyms:
-  - single pointer inputs
 ---
 
-input modality that only targets a single point on the :term[view] at a time – such as a mouse, single finger on a touch screen, or stylus
+input modality that only targets a single point on the :term[page]/:term[view] at a time – such as a mouse, single finger on a touch screen, or stylus
 
 :::note
 Single pointer interactions include clicks, double clicks, taps, dragging motions, and single-finger swipe gestures. In contrast, multipoint interactions involve the use of two or more pointers at the same time, such as two-finger interactions on a touchscreen, or the simultaneous use of a mouse and stylus.

guidelines/terms/standard-platform-keyboard-commands.md

@@ -2,7 +2,7 @@
 status: developing
 ---
 
-keyboard commands that are the same across most or platforms and are relied upon by users who need to navigate by keyboard alone
+keyboard commands that are the same across most or all platforms and are relied upon by users who need to navigate by keyboard alone
 
 :::note
 A sufficient listing of common keyboard navigation techniques for use by authors can be found in [Standard Keyboard Navigation & Operation Keys and Techniques](https://github.com/w3c/wcag3/wiki/Standard-Keyboard-Navigation-&-Operation-Keys-and-Techniques).