diff --git a/README.md b/README.md index c2019213..3d9ce521 100644 --- a/README.md +++ b/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. diff --git a/guidelines/groups/consistency-across-views/consistency/consistent-navigation-order.md b/guidelines/groups/consistency-across-views/consistency/consistent-navigation-order.md index ae085ea5..ad241a74 100644 --- a/guidelines/groups/consistency-across-views/consistency/consistent-navigation-order.md +++ b/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 diff --git a/guidelines/groups/consistency-across-views/consistency/consistent-structural-order.md b/guidelines/groups/consistency-across-views/consistency/consistent-structural-order.md index c2242e70..bc5561c1 100644 --- a/guidelines/groups/consistency-across-views/consistency/consistent-structural-order.md +++ b/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 diff --git a/guidelines/groups/images-and-media/captions/captions-synchronized.md b/guidelines/groups/images-and-media/captions/captions-synchronized.md index 71e7bd93..30f8e4c0 100644 --- a/guidelines/groups/images-and-media/captions/captions-synchronized.md +++ b/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 Procedure diff --git a/guidelines/groups/images-and-media/single-sense/spatial-audio-not-relied-on.md b/guidelines/groups/images-and-media/single-sense/spatial-audio-not-relied-on.md index 4c7915be..b3beb354 100644 --- a/guidelines/groups/images-and-media/single-sense/spatial-audio-not-relied-on.md +++ 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. diff --git a/guidelines/groups/input-operation/authentication/biometrics-not-relied-on.md b/guidelines/groups/input-operation/authentication/biometrics-not-relied-on.md index fa1dec28..6b4210ec 100644 --- a/guidelines/groups/input-operation/authentication/biometrics-not-relied-on.md +++ b/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. diff --git a/guidelines/groups/input-operation/authentication/multiple-biometrics-available.md b/guidelines/groups/input-operation/authentication/multiple-biometrics-available.md index 3c661332..ac492e99 100644 --- a/guidelines/groups/input-operation/authentication/multiple-biometrics-available.md +++ b/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 diff --git a/guidelines/groups/input-operation/pointer-input/simple-pointer-input-available.md b/guidelines/groups/input-operation/pointer-input/simple-pointer-input-available.md index 7a0c3cc1..1b6b5a75 100644 --- a/guidelines/groups/input-operation/pointer-input/simple-pointer-input-available.md +++ b/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 diff --git a/guidelines/groups/interactive-components/control-information/roles-values-states-properties-available.md b/guidelines/groups/interactive-components/control-information/roles-values-states-properties-available.md index 4fe9534b..536d3e02 100644 --- a/guidelines/groups/interactive-components/control-information/roles-values-states-properties-available.md +++ b/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. -::: \ No newline at end of file +::: diff --git a/guidelines/groups/interactive-components/keyboard-focus-appearance/default-focus-indicator-used.md b/guidelines/groups/interactive-components/keyboard-focus-appearance/default-focus-indicator-used.md index 24cee273..02e24e48 100644 --- a/guidelines/groups/interactive-components/keyboard-focus-appearance/default-focus-indicator-used.md +++ b/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** diff --git a/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-contrast-sufficient.md b/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-contrast-sufficient.md index 2365eff7..0d5e6c23 100644 --- a/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-contrast-sufficient.md +++ b/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. diff --git a/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-size-sufficient.md b/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-size-sufficient.md index af6bcea1..c295638c 100644 --- a/guidelines/groups/interactive-components/keyboard-focus-appearance/focus-indicator-size-sufficient.md +++ b/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. diff --git a/guidelines/groups/layout/user-orientation/page-view-title-available.md b/guidelines/groups/layout/user-orientation/page-view-title-available.md index 8dd73957..e78d1156 100644 --- a/guidelines/groups/layout/user-orientation/page-view-title-available.md +++ b/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. diff --git a/guidelines/groups/text-and-wording/clear-language/common-words-used.md b/guidelines/groups/text-and-wording/clear-language/common-words-used.md index f80d4e73..23308148 100644 --- a/guidelines/groups/text-and-wording/clear-language/common-words-used.md +++ b/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 diff --git a/guidelines/groups/text-and-wording/clear-language/diacritics-available.md b/guidelines/groups/text-and-wording/clear-language/diacritics-available.md index b0d8fa89..02cf7834 100644 --- a/guidelines/groups/text-and-wording/clear-language/diacritics-available.md +++ b/guidelines/groups/text-and-wording/clear-language/diacritics-available.md @@ -6,7 +6,7 @@ type: supplemental 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 diff --git a/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-enhanced.md b/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-enhanced.md index 228421c3..c5a35d1e 100644 --- a/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-enhanced.md +++ b/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. diff --git a/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-minimum.md b/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-minimum.md index 21433577..852a2331 100644 --- a/guidelines/groups/text-and-wording/text-appearance/text-contrast-sufficient-minimum.md +++ b/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. diff --git a/guidelines/groups/text-and-wording/text-to-speech.md b/guidelines/groups/text-and-wording/text-to-speech.md index 860b59f1..0a789ad4 100644 --- a/guidelines/groups/text-and-wording/text-to-speech.md +++ b/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. \ No newline at end of file diff --git a/guidelines/groups/text-and-wording/text-to-speech/human-language-detectable.md b/guidelines/groups/text-and-wording/text-to-speech/human-language-detectable.md index 498d9af0..aa70c609 100644 --- a/guidelines/groups/text-and-wording/text-to-speech/human-language-detectable.md +++ b/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 diff --git a/guidelines/terms/diacritic.md b/guidelines/terms/clear-language.md similarity index 100% rename from guidelines/terms/diacritic.md rename to guidelines/terms/clear-language.md diff --git a/guidelines/terms/color-contrast.md b/guidelines/terms/color-contrast.md index 2d66c0f5..bc27a7e3 100644 --- a/guidelines/terms/color-contrast.md +++ b/guidelines/terms/color-contrast.md @@ -1,5 +1,6 @@ --- status: developing +unusedDefinition: true --- relationship of hue, saturation, and lightness values between two colors \ No newline at end of file diff --git a/guidelines/terms/complex-pointer-input.md b/guidelines/terms/complex-pointer-input.md index 8891c549..e372ef11 100644 --- a/guidelines/terms/complex-pointer-input.md +++ b/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 diff --git a/guidelines/terms/css-pixels.md b/guidelines/terms/css-pixel.md similarity index 99% rename from guidelines/terms/css-pixels.md rename to guidelines/terms/css-pixel.md index d45952b8..d10c8261 100644 --- a/guidelines/terms/css-pixels.md +++ b/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). -::: \ No newline at end of file +::: diff --git a/guidelines/terms/essential-exception.md b/guidelines/terms/essential-exception.md index 4937df8d..72733aec 100644 --- a/guidelines/terms/essential-exception.md +++ b/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 diff --git a/guidelines/terms/figure-captions.md b/guidelines/terms/figure-caption.md similarity index 66% rename from guidelines/terms/figure-captions.md rename to guidelines/terms/figure-caption.md index 77eb0db0..9fb0f7c2 100644 --- a/guidelines/terms/figure-captions.md +++ b/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 \ No newline at end of file +title, brief explanation, or comment that accompanies a work of visual media and is always visible on the page diff --git a/guidelines/terms/human language.md b/guidelines/terms/human language.md deleted file mode 100644 index fb3e4066..00000000 --- a/guidelines/terms/human language.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -status: exploratory ---- - -language that is spoken, written or signed (through visual or tactile means) to communicate with humans - -:::note -See also :term[sign language]. -::: diff --git a/guidelines/terms/human-language.md b/guidelines/terms/human-language.md new file mode 100644 index 00000000..1b8c59bd --- /dev/null +++ b/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]. +::: diff --git a/guidelines/terms/image-role.md b/guidelines/terms/image-role.md index 38cbe65a..4b8b001b 100644 --- a/guidelines/terms/image-role.md +++ b/guidelines/terms/image-role.md @@ -1,5 +1,4 @@ --- status: placeholder -synonyms: - - role +unusedDefinition: true --- diff --git a/guidelines/terms/transcripts.md b/guidelines/terms/infinite-scrolling.md similarity index 100% rename from guidelines/terms/transcripts.md rename to guidelines/terms/infinite-scrolling.md diff --git a/guidelines/terms/meaningful-blocks-of-content.md b/guidelines/terms/meaningful-blocks-of-content.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/meaningful-blocks-of-content.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/minimum-bounding-box.md b/guidelines/terms/minimum-bounding-box.md index 5581a71c..9de473fb 100644 --- a/guidelines/terms/minimum-bounding-box.md +++ b/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 diff --git a/guidelines/terms/non-decorative-image.md b/guidelines/terms/non-decorative-image.md new file mode 100644 index 00000000..8000d72d --- /dev/null +++ b/guidelines/terms/non-decorative-image.md @@ -0,0 +1,4 @@ +--- +status: placeholder +title: non-decorative image +--- diff --git a/guidelines/terms/non-decorative-images.md b/guidelines/terms/non-decorative-images.md deleted file mode 100644 index 1b839578..00000000 --- a/guidelines/terms/non-decorative-images.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -status: placeholder -title: non-decorative images ---- diff --git a/guidelines/terms/non-text-content.md b/guidelines/terms/non-text-content.md index d920e1bb..a2da232b 100644 --- a/guidelines/terms/non-text-content.md +++ b/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 diff --git a/guidelines/terms/open-captions.md b/guidelines/terms/open-captions.md deleted file mode 100644 index dce7f626..00000000 --- a/guidelines/terms/open-captions.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -status: developing ---- - -captions that are visual equivalent images of text that are embedded in video - - -:::note -Open captions are also known as burned-in, baked-on, or hard-coded captions. Open captions cannot be turned off and cannot be read using assistive technology. -::: \ No newline at end of file diff --git a/guidelines/terms/platform.md b/guidelines/terms/platform.md index 3add2694..1e72ecf1 100644 --- a/guidelines/terms/platform.md +++ b/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. ::: \ No newline at end of file diff --git a/guidelines/terms/presentation.md b/guidelines/terms/presentation.md index fb2e3754..76f953f7 100644 --- a/guidelines/terms/presentation.md +++ b/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 \ No newline at end of file diff --git a/guidelines/terms/private-and-sensitive-information.md b/guidelines/terms/private-and-sensitive-information.md index c443fcd1..10fe7c20 100644 --- a/guidelines/terms/private-and-sensitive-information.md +++ b/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 diff --git a/guidelines/terms/product.md b/guidelines/terms/product.md index 955be629..357faaf1 100644 --- a/guidelines/terms/product.md +++ b/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]. diff --git a/guidelines/terms/relationship-of-meaning.md b/guidelines/terms/relationship-of-meaning.md new file mode 100644 index 00000000..00603a18 --- /dev/null +++ b/guidelines/terms/relationship-of-meaning.md @@ -0,0 +1,5 @@ +--- +status: placeholder +synonyms: + - relationships of meaning +--- diff --git a/guidelines/terms/rendered-content.md b/guidelines/terms/rendered-content.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/rendered-content.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/semi-automated-evaluation.md b/guidelines/terms/semi-automated-evaluation.md index f014ad16..b3979093 100644 --- a/guidelines/terms/semi-automated-evaluation.md +++ b/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 diff --git a/guidelines/terms/single-pointer-input.md b/guidelines/terms/single-pointer-input.md index dcd1095d..e4a863f1 100644 --- a/guidelines/terms/single-pointer-input.md +++ b/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. diff --git a/guidelines/terms/single-pointer.md b/guidelines/terms/single-pointer.md deleted file mode 100644 index 4539a11c..00000000 --- a/guidelines/terms/single-pointer.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -status: developing ---- - -input modality that only targets a single point on the page/screen 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. -::: \ No newline at end of file diff --git a/guidelines/terms/standard-platform-keyboard-commands.md b/guidelines/terms/standard-platform-keyboard-commands.md index 581d8e88..c98c21bd 100644 --- a/guidelines/terms/standard-platform-keyboard-commands.md +++ b/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). diff --git a/guidelines/terms/starting-point.md b/guidelines/terms/starting-point.md index 5efa9067..51517e73 100644 --- a/guidelines/terms/starting-point.md +++ b/guidelines/terms/starting-point.md @@ -2,4 +2,4 @@ status: developing --- -the home page of a web site or a set of web pages in a web site \ No newline at end of file +the home page of a website or a set of web pages in a website \ No newline at end of file diff --git a/guidelines/terms/states.md b/guidelines/terms/state.md similarity index 99% rename from guidelines/terms/states.md rename to guidelines/terms/state.md index a1ae602b..9728e1c3 100644 --- a/guidelines/terms/states.md +++ b/guidelines/terms/state.md @@ -6,4 +6,4 @@ dynamic property expressing characteristics of a :term[user interface component] :::note States represent data associated with the component or user interaction possibilities. They do not affect the nature of the component. Examples include focus, hover, select, press, check, visited/unvisited, and expand/collapse. -::: \ No newline at end of file +::: diff --git a/guidelines/terms/structural-component.md b/guidelines/terms/structural-component.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/structural-component.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/style-property.md b/guidelines/terms/style-property.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/style-property.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/test.md b/guidelines/terms/test.md index 0052892d..de82bed6 100644 --- a/guidelines/terms/test.md +++ b/guidelines/terms/test.md @@ -1,5 +1,6 @@ --- status: developing +unusedDefinition: true --- mechanism to evaluate implementation of a :term[method] \ No newline at end of file diff --git a/guidelines/terms/text.md b/guidelines/terms/text.md index e97b318d..41a8a8a5 100644 --- a/guidelines/terms/text.md +++ b/guidelines/terms/text.md @@ -2,4 +2,4 @@ status: developing --- -sequence of characters that can be :term[programmatically determined], where the sequence is expressing something in human language \ No newline at end of file +sequence of characters that can be :term[programmatically determined], where the sequence is expressing something in :term[human language] diff --git a/guidelines/terms/transcript.md b/guidelines/terms/transcript.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/transcript.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/unnecessary-words.md b/guidelines/terms/unnecessary-words.md index 11885959..84a77a51 100644 --- a/guidelines/terms/unnecessary-words.md +++ b/guidelines/terms/unnecessary-words.md @@ -2,7 +2,7 @@ status: exploratory --- -using extra words or complicated phrases that can be removed or replaced with simpler ones without changing the meaning of the :term[text content] +extra words or complicated phrases that can be removed or replaced with simpler ones without changing the meaning of the :term[text content] :::example * due to the fact that → because diff --git a/guidelines/terms/user-interface-component.md b/guidelines/terms/user-interface-component.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/user-interface-component.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/user-manipulable-text.md b/guidelines/terms/user-manipulable-text.md index 3a44cc4e..b607701f 100644 --- a/guidelines/terms/user-manipulable-text.md +++ b/guidelines/terms/user-manipulable-text.md @@ -1,6 +1,7 @@ --- status: developing -title: User-manipulable text +title: user-manipulable text +unusedDefinition: true --- text which the user can adjust @@ -20,4 +21,4 @@ This could include, but is not limited to, changing: * Capitalization — all caps, small caps, alternating case * End of line hyphenation * Links -::: \ No newline at end of file +::: diff --git a/guidelines/terms/variation-of-product-or-process.md b/guidelines/terms/variation-of-product-or-process.md new file mode 100644 index 00000000..5768a31c --- /dev/null +++ b/guidelines/terms/variation-of-product-or-process.md @@ -0,0 +1,3 @@ +--- +status: placeholder +--- diff --git a/guidelines/terms/viewport.md b/guidelines/terms/viewport.md index b70aad04..dda0a406 100644 --- a/guidelines/terms/viewport.md +++ b/guidelines/terms/viewport.md @@ -13,7 +13,7 @@ Content can be presented through one or more viewports. Viewports include window ::: :::example -For a webpage author, the viewport is the HTML viewport. +For a web page author, the viewport is the HTML viewport. ::: :::example diff --git a/src/components/guidelines/GlossaryDefinition.astro b/src/components/guidelines/GlossaryDefinition.astro index a6d009bf..b4750c61 100644 --- a/src/components/guidelines/GlossaryDefinition.astro +++ b/src/components/guidelines/GlossaryDefinition.astro @@ -8,11 +8,11 @@ interface Props { } const { termEntry } = Astro.props; -const { status, synonyms } = termEntry.data; +const { status, synonyms, unusedDefinition } = termEntry.data; const { Content } = await render(termEntry); ---
- {computeTermTitle(termEntry)} + {computeTermTitle(termEntry)}
diff --git a/src/content.config.ts b/src/content.config.ts index 5f51a023..dcba62c0 100644 --- a/src/content.config.ts +++ b/src/content.config.ts @@ -87,6 +87,7 @@ export const collections = { schema: commonChildSchema.omit({ howto: true }).extend({ status: statusSchema.optional(), synonyms: z.array(z.string()).min(1).optional(), + unusedDefinition: z.boolean().optional(), }), }), };