diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial index 592edd0..34eaac8 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial @@ -33,7 +33,7 @@ @TutorialReference(tutorial: "doc:AdaptCells") } - @Chapter(name: "Reduce Number of Controls") { + @Chapter(name: "Simplify User Scenarios") { @Image(source: chapter-placeholder.png, alt: "") Re-structure complex collections that way so it is easier to navigate between them. @@ -48,7 +48,7 @@ @TutorialReference(tutorial: "doc:OnScreen-Navigation") @TutorialReference(tutorial: "doc:Containers") - @TutorialReference(tutorial: "doc:FocusOrder") + @TutorialReference(tutorial: "doc:FocusManagement") @TutorialReference(tutorial: "doc:Between-ScreensNavigation") } } @@ -73,6 +73,8 @@ @TutorialReference(tutorial: "doc:AdjustableElements") @TutorialReference(tutorial: "doc:HideUselessControls") + @TutorialReference(tutorial: "doc:TextInput") + @TutorialReference(tutorial: "doc:ErrorPrevention") } @Chapter(name: "Provide Details") { @@ -86,16 +88,7 @@ @TutorialReference(tutorial: "doc:AlternativeDescription") } - @Chapter(name: "Adapt Content") { - @Image(source: chapter-placeholder.png, alt: "") - - There are several options that is rare needed, but you can be interested in - - @TutorialReference(tutorial: "doc:TextInput") - @TutorialReference(tutorial: "doc:ErrorPrevention") - } - - @Chapter(name: "Colors And Shapes") { + @Chapter(name: "Appearance") { @Image(source: chapter-placeholder.png, alt: "") Follow specific guidelines to make your GUI easy to comprehend. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleGraphics/ColorsAndShapes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleGraphics/ColorsAndShapes.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleGraphics/DynamicType.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/DynamicType.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleGraphics/DynamicType.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/DynamicType.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/AdjustableElements.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/AdjustableElements.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_1.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_1.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_1.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_1.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_2.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_2.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_2.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_2.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_3.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_3.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_3.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_3.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_4.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_4.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_4.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_4.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_5.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_5.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/Resources/AdjustableTutorialStep_5.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/Resources/AdjustableTutorialStep_5.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/aAdjustableElements.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/AdjustableElements/aAdjustableElements.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/CustomActions.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/CustomActions.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/CustomActions.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/CustomActions.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/CustomRotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/CustomRotor.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/CustomRotor.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/CustomRotor.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/MotorDisabilities.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/MotorDisabilities.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/MotorDisabilities.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/MotorDisabilities.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/Rotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/Rotor.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/Rotor.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/Rotor.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/aVerticalSwipes.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/Controls/aVerticalSwipes.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleCharts/AccessibleCharts.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleCharts/AccessibleCharts.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleListening/AccessibleListening.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleListening/AccessibleListening.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleReading/AccessibleReading.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleReading/AccessibleReading.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AccessibleReading/AccessibleReading.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AccessibleReading/AccessibleReading.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AlternativeDescription/AlternativeDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/AlternativeDescription/AlternativeDescription.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/butterfly.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/butterfly.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/butterfly.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/butterfly.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/color-blindness.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/color-blindness.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/color-blindness.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/color-blindness.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/earth.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/earth.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/earth.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/earth.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/eye-injury.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/eye-injury.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/eye-injury.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/eye-injury.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/eyes.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/eyes.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/eyes.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/eyes.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/fish.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/fish.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/fish.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/fish.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/frogs.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/frogs.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/frogs.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/frogs.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/magnifying-glass.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/magnifying-glass.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/magnifying-glass.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/magnifying-glass.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/newborn-albino.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/newborn-albino.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/newborn-albino.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/newborn-albino.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/senses.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/senses.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/senses.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/senses.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/senses~dark.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/senses~dark.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/Resources/senses~dark.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/Resources/senses~dark.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/SensorySystem.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/SensorySystem.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/SensorySystem.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleDescription/SensorySystem.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceControl/VoiceControl.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceControl/VoiceControl.md index b3df870..c97e8f7 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceControl/VoiceControl.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceControl/VoiceControl.md @@ -19,51 +19,96 @@ Use voice to operate an iPhone label: "General Knowledge") } +**Voice Control** is a feature that enables *controlling* an **iPhone** with **speech commands**. + + [![Alternate Text](ian)](https://www.youtube.com/watch?v=eePfgI2TT_Q) + +## How Does It Function +The mechanism of this technology is to *recognise* its user's **voice commands** and perform appropriate *actions*. + +@Image(source: "vc-mech", alt: "") { + The recognition converts the **audial input** of the user to **textual speech** and *looks for an element* with **matching description**. +} + +### Voice Control Users +Such technology is used by those people who **cannot operate the device physically**. + @Row { @Column { - @Image(source: "placeholder-image", alt: "") { - Placeholder + @Image(source: permanent-arms, alt: "") { + Not having hands is a **permanent** disability + } + } + @Column { + + @Image(source: temporary-arms, alt: "") { + Having hands busy is a **temporary** disability } } } -Voice Control is a feature that enables controlling an iPhone with speech commands. +They may have **motor** or **cognitive** limitations of both **temporary** or **permanent** kinds, so **Voice Control** is helpful as for a person who can't touch their phone during **driving** or **holding a child** as for someone who *lacks* the ability to control something by **touch** all the time. -The mechanism of this technology is to recognise its user's voice commands and perform appropriate actions. The recognition converts the audial input of the user to textual speech and looks for an element with matching description. +### Voice Control Is Not Siri -### Voice Control Users -Such technology is used by those people who cannot operate the device physically. +@Image(source: sirikit, alt: "") { + Visit SiriKit official documentation +} -They may have motor or cognitive limitations of both temporary or permanent kinds, so Voice Control is helpful as for a person who can't touch their phone during driving as for someone who lacks the ability to control something by touch all the time. +[**Siri**](https://www.apple.com/siri/) is a **digital assistant** native for any **Apple** device. **Siri** does indeed use **voice commands** to things its [*programmed to*](https://developer.apple.com/siri/), but the key difference between **Siri** and **Voice Control** is that the later is **unconditional**. -### Voice Control Is Not Siri +@Image(source: service-vs-tech, alt: "") { + Siri is a service while Voice Control is a technology +} -Siri is a digital assistant native for any Apple device. Siri does indeed use voice commands to things its programmed to, but the key difference between Siri and Voice Control is that the later is unconditional. It means that Voice Control is not relying on scripts it knows but takes the system's code and allows its user do whatever they want just as if they used the device the regular way. +It means that **Voice Control** is *not relying on scripts it knows* but takes the system's code and allows its user do **whatever** they want just as if they used the device the regular way. ### Grid Layout -Yes, the Voice Control experience is heavily influenced by accessibility of a particular app, but even if there is no accessibility adaption work done at all the user may still use the app. It is possible in Grid Layout mode of the feature: a case of Voice Control GUI where the screen is shattered into small enumerated parts so the user can simulate touching a particular point of the screen by calling the number of the cell. -This layout option is truly unconditional because other two depend on the accessibility of interface elements: Show Item Names will show captions for only those elements that have labels stated, Show Item Numbers will enumerate elements if they are marked as accessibility elements. Grid just draws the same grid on top of any interface. +Yes, the **Voice Control** experience is heavily influenced by *accessibility* of a particular app, but even if there is **no accessibility** adaption work done *at all* the user may still use the app. It is possible in **Grid Layout** mode of the feature: a case of **Voice Control** GUI where the screen is shattered into small enumerated parts so the user can simulate *touching* a particular point of the screen by **calling the number of the cell**. + +@Image(source: grid, alt: "") { + Grid view is commonly used to navigate maps +} + +This layout option is truly **unconditional** because other two depend on the *accessibility* of interface elements: +- **Show Item Names** will show **captions** for only those elements that have [**labels stated**](); +- **Show Item Numbers** will enumerate elements if they are marked as [**accessibility elements**](); +- **Grid Layout** just draws the *same* grid on top of **any interface**. #### Voice Control Is... Switch Control -Considering the fact that we are in iOS Accessibility Handbook and have to have a deeper understanding of assistive software, Voice Control is essentially a case of Switch Control. It just uses microphone as a switch interface and has much more actions possible to perform. +Considering the fact that we are in **iOS Accessibility Handbook** and have to have a *deeper understanding* of [**assistive software**](), **Voice Control** is essentially a case of [**Switch Control**](). It just uses a *microphone* as a **switch interface** and has much more **actions** possible to perform. ### Languages Voice Control Understands -At the moment Voice Control is only available in English, French, German, Spanish, Japanese and Chinese language, so it won't be possible to fully operate an iPhone by speech it does not yet support. +At the moment **Voice Control** is only available in English, French, German, Spanish, Japanese and Chinese languages, so it won't be possible to fully operate an iPhone by speech it does not yet support. ### Speechless Voice Control -Though one always can control the device by sounds that are not inherent to any language or voice at all. It can be done in Switch Control settings by choosing Sound option in switches menu. -This feature is useful for those people who cannot produce speech but are still able to make sounds. It is a common case for speech disfunction, whose pathogenesis diversity is above this book's level. +Though one always can control the device by [**sounds**](https://en.wikipedia.org/wiki/Paralanguage) that are not inherent to *any* language or voice at all. It can be done in [**Switch Control**]() settings by choosing **Sound** option in **switches menu**. + +@Image(source: sc-sound-setup, alt: "") + +This feature is useful for those people who **cannot produce speech** but are still able to make sounds. It is a common case for **speech disfunction**, whose pathogenesis diversity is above this book's level. + +@Image(source: nonverbal, alt: "") + ## Trying out Voice Control -To turn Voice Control on go to Setting and find Voice Control feature in Accessibility settings. +To turn **Voice Control** on go to **Settings** and find **Voice Control** feature in **Accessibility** settings. @Image(source: vc-setup, alt: "") ## Supporting Voice Control in Applications +Accessibility adaption for Voice Control can be boiled down to enabling the interactive elements to be accessible and giving them succinct localised names. ## Naming guidelines +For an element's name to be succinct it has to be as short as possible without losing information necessary to distinct this element from others and comprehend everything that should be delivered. + +### Bad examples + +### Good Examples + ## Use of synonyms + @Comment { https://www.apple.com/macos/big-sur/docs/Voice_Control_Tech_Brief_Sept_2019.pdf } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md index c6f26b0..7a3887c 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md @@ -89,44 +89,49 @@ Reading the book one may sometimes notice screenshots of iOS applications with * ### Adapting Strategy - -### Must-Have Functionality +### Accessible Elements - - - -- + +### Accessible Scenarios - -- -- +- - - + +### Accessible Interface +- +- +- + ### Greater Accessible Experience - -### Accessible Graphics +### Accessible Appearance - - +- -### Adapt Content +### Accessible Description - - - - - -### Controls +### Accessible Controls - +- - - -- -- -- -### Input -- +- -### Miscellaneous -- +### Accessible Navigation +- +- ### What's Next? - diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/IMG_6132.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/IMG_6132.PNG new file mode 100644 index 0000000..8ed3fc3 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/IMG_6132.PNG differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/schemes-2.key b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/schemes-2.key new file mode 100755 index 0000000..c01d86a Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/schemes-2.key differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/video-previews.key b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/video-previews.key index 6e60bbd..e56f15d 100755 Binary files a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/video-previews.key and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/Keynote/video-previews.key differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/grid.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/grid.PNG new file mode 100644 index 0000000..34ca0b4 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/grid.PNG differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/ian.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/ian.png new file mode 100644 index 0000000..5e45986 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/ian.png differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/permanent-arms.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/permanent-arms.PNG new file mode 100644 index 0000000..00282b8 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/permanent-arms.PNG differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sady.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sady.png new file mode 100644 index 0000000..f542cd6 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sady.png differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit.png new file mode 100644 index 0000000..b5a3dbd Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit.png differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit~dark.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit~dark.png new file mode 100644 index 0000000..f20045a Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/sirikit~dark.png differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/temporary-arms.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/temporary-arms.PNG new file mode 100644 index 0000000..1fae9fa Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/temporary-arms.PNG differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech.png new file mode 100644 index 0000000..f0dc4b7 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech.png differ diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech~dark.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech~dark.png new file mode 100644 index 0000000..ef78ba0 Binary files /dev/null and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/vc-mech~dark.png differ