From 673df50691edd476e0a2ce75e66c691887089685 Mon Sep 17 00:00:00 2001 From: "C." Date: Fri, 10 May 2024 15:22:00 +0300 Subject: [PATCH] a little bit of cleaning --- .../Activism/AccessibilityActivism.tutorial | 2 +- .../AccessibilityTree.tutorial | 6 - .../Design/Standarts/Standarts.tutorial | 30 +-- .../Pages/Enterprise/Processes.tutorial | 16 -- .../Enterprise/Testing/Manual/Manual.tutorial | 22 +- .../SnapshotTesting/SnapshotTesting.tutorial | 21 +- .../Pages/Integration/AdoptionGuide.tutorial | 33 ++- .../AccessibleCharts.tutorial | 38 +++ .../AccessibleListening.tutorial | 65 +++++ .../AccessibleReading.tutorial | 0 .../AlternativeDescription.tutorial | 59 +++++ .../Resources/butterfly.png | Bin .../Resources/color-blindness.png | Bin .../Resources/earth.png | Bin .../Resources/eye-injury.png | Bin .../Resources/eyes.png | Bin .../Resources/fish.png | Bin .../Resources/frogs.png | Bin .../Resources/magnifying-glass.png | Bin .../Resources/newborn-albino.png | Bin .../Resources/senses.png | Bin .../Resources/senses~dark.png | Bin .../AdjustableElements.tutorial | 245 ++++++++++++------ .../aAdjustableElements.tutorial | 68 ----- .../ErrorPrevention/ErrorPrevention.tutorial | 5 - .../AccessibleControls/Frame/Frame.tutorial | 23 +- .../Haptics/Haptics.tutorial | 12 + .../Input/TextInput.tutorial | 17 -- .../KeyboardShortcuts.tutorial | 20 +- .../AccessibleControls/Rotor.tutorial | 18 -- .../Traits/Code/SwiftUI/addTraits.swift | 0 .../Code/SwiftUI/allowsDirectTouch.swift | 0 .../Traits/Code/SwiftUI/budgetSlider.swift | 0 .../Traits/Code/SwiftUI/isToggle.swift | 0 .../Traits/Code/UIKit/directTouch.swift | 0 .../Traits/Code/UIKit/hiddenTraits.swift | 0 .../Traits/Code/UIKit/optionSet.swift | 0 .../Traits/Code/UIKit/toggleButton.swift | 0 .../Traits/Images/adjustable.PNG | Bin .../Traits/Images/adjustable~dark.PNG | Bin .../Traits/Images/buttons.PNG | Bin .../Traits/Images/buttons~dark.PNG | Bin .../Traits/Images/controls.PNG | Bin .../Traits/Images/controls~dark.PNG | Bin .../Traits/Images/direct-interaction.PNG | Bin .../Traits/Images/direct-interaction~dark.PNG | Bin .../Traits/Images/headers.PNG | Bin .../Traits/Images/images.PNG | Bin .../Traits/Images/images~dark.PNG | Bin .../Traits/Images/keys.PNG | Bin .../Traits/Images/links.PNG | Bin .../Traits/Images/media-session.PNG | Bin .../Traits/Images/modal.PNG | Bin .../Traits/Images/modal~dark.PNG | Bin .../Traits/Images/not-enabled.PNG | Bin .../Traits/Images/plays-sound.PNG | Bin .../Traits/Images/search-field.PNG | Bin .../Traits/Images/search-field~dark.PNG | Bin .../Traits/Images/selected.PNG | Bin .../Traits/Images/selected~dark.PNG | Bin .../Traits/Images/static-text.PNG | Bin .../Traits/Images/static-text~dark.PNG | Bin .../Traits/Images/summary-element.PNG | Bin .../Traits/Images/tabs.PNG | Bin .../Traits/Images/tabs~dark.PNG | Bin .../Traits/Images/toggles.PNG | Bin .../Traits/Images/toggles~dark.PNG | Bin .../Traits/Images/updates-frequently.PNG | Bin .../Traits/Traits.tutorial | 4 +- .../AccessibleCharts.tutorial | 23 -- .../AccessibleListening.tutorial | 40 --- .../AlternativeDescription.tutorial | 39 --- .../AccessibleNavigation/Containers.tutorial | 24 +- ...chy.tutorial => ControlHierarchy.tutorial} | 3 +- .../CustomActions.tutorial | 12 +- .../AccessibleNavigation/CustomRotor.tutorial | 10 +- .../Error-Handling/Error-Handling.tutorial | 16 ++ .../AccessibleNavigation/Haptics.tutorial | 29 --- .../HideUselessControls.tutorial | 17 -- .../HorizontalSwipes.tutorial | 29 +-- .../Notifications.tutorial | 30 +-- .../On-Screen/ControlHierarchy.tutorial | 17 -- .../On-Screen/FocusManagement.tutorial | 17 -- .../On-Screen/On-ScreenNavigation.tutorial | 11 + .../On-Screen/OnScreen-Navigation.tutorial | 17 -- .../VerticalSwipes.tutorial | 14 + .../aVerticalSwipes.tutorial | 33 --- .../ColorsAndShapes/ColorsAndShapes.tutorial | 180 ------------- .../ColoursAndShapes.tutorial | 198 ++++++++++++++ ...cType.tutorial => InterfaceScale.tutorial} | 2 +- .../Privacy/Privacy.tutorial | 29 --- .../ReduceMotion/ReduceMotion.tutorial | 17 ++ .../ReducedMotion/ReducedMotion.tutorial | 103 -------- .../Simplify/AdaptCells/AdaptCells.tutorial | 2 +- .../AccessibilityFeatures.md | 2 +- .../AssistiveAccess/AssistiveAccess.md | 3 +- .../{aDynamicType.md => DynamicType.md} | 2 +- .../{aGuidedAccess.md => GuidedAccess.md} | 0 .../GuidedAccess/GuidedAccess.tutorial | 29 --- .../SwitchControl/SwitchControl.md | 2 - .../VoiceOver/VoiceOver.md | 2 +- .../iOS Accessibility/iOSAccessibility.md | 2 +- .../Pages/iOSAccessibilityHandbook.md | 4 +- 103 files changed, 690 insertions(+), 972 deletions(-) delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleCharts/AccessibleCharts.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleListening/AccessibleListening.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/AccessibleReading/AccessibleReading.tutorial (100%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AlternativeDescription/AlternativeDescription.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/butterfly.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/color-blindness.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/earth.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/eye-injury.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/eyes.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/fish.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/frogs.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/magnifying-glass.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/newborn-albino.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/senses.png (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleContent}/Resources/senses~dark.png (100%) delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/ErrorPrevention/ErrorPrevention.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Haptics/Haptics.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Input/TextInput.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Rotor.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/SwiftUI/addTraits.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/SwiftUI/allowsDirectTouch.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/SwiftUI/budgetSlider.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/SwiftUI/isToggle.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/UIKit/directTouch.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/UIKit/hiddenTraits.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/UIKit/optionSet.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Code/UIKit/toggleButton.swift (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/adjustable.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/adjustable~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/buttons.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/buttons~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/controls.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/controls~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/direct-interaction.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/direct-interaction~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/headers.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/images.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/images~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/keys.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/links.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/media-session.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/modal.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/modal~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/not-enabled.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/plays-sound.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/search-field.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/search-field~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/selected.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/selected~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/static-text.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/static-text~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/summary-element.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/tabs.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/tabs~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/toggles.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/toggles~dark.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Images/updates-frequently.PNG (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/{AccessibleDescription => AccessibleControls}/Traits/Traits.tutorial (99%) delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/{On-Screen/aControlHierarchy.tutorial => ControlHierarchy.tutorial} (98%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Error-Handling/Error-Handling.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Haptics.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HideUselessControls.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/On-ScreenNavigation.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/VerticalSwipes.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/aVerticalSwipes.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColorsAndShapes/ColorsAndShapes.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColoursAndShapes/ColoursAndShapes.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/{DynamicType.tutorial => InterfaceScale.tutorial} (98%) delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/Privacy/Privacy.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReduceMotion/ReduceMotion.tutorial delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReducedMotion/ReducedMotion.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/{aDynamicType.md => DynamicType.md} (97%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/{aGuidedAccess.md => GuidedAccess.md} (100%) delete mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial index d6b714d..7a7eeb9 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial @@ -1,5 +1,5 @@ @Article(time: 10) { - @Intro(title: "Advocating for Accessibility as an iOS Developer") { + @Intro(title: "Advocating for Accessibility as an Apple Developer") { @Comment { axe-con diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial deleted file mode 100644 index 0eaca04..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial +++ /dev/null @@ -1,6 +0,0 @@ -@Tutorial(time: 10) { - @Intro(title: "Creating Mental Models of User Interfaces") { - <#text#> - - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/Standarts/Standarts.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/Standarts/Standarts.tutorial index 880b88e..ba38bde 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/Standarts/Standarts.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/Standarts/Standarts.tutorial @@ -1,29 +1,9 @@ -@Tutorial(time: 15) { - @Intro(title: "Accessibility Compliance of iOS Applications") { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") +@Article(time: 15) { + @Intro(title: "iOS Applications Accessibility Conformance") { + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } + @ContentAndMedia { + ## WCAG ICT } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial deleted file mode 100644 index e66eea5..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial +++ /dev/null @@ -1,16 +0,0 @@ -@Article(time: 15) { - @Intro(title: "Enterprise of Accessibility") { - - } - - - @ContentAndMedia { - ## Grassroot efforts - @Image(source: placeholder-image, alt: "") - } - - @ContentAndMedia { - ## Grassroot efforts - @Image(source: placeholder-image, alt: "") - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/Manual/Manual.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/Manual/Manual.tutorial index 819b895..f969028 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/Manual/Manual.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/Manual/Manual.tutorial @@ -1,28 +1,20 @@ -@Tutorial(time: <#number#>) { +@Tutorial(time: 15) { @Intro(title: "Manual Testing of iOS Applications") { - <#text#> + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) + An instructional message. } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial index 79bef0c..2130c60 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial @@ -1,29 +1,20 @@ @Tutorial(time: 20) { @Intro(title: "Snapshot Accessibility Testing") { - <#text#> + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) + An instructional message. } } } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial index df9df80..a7e91a6 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial @@ -49,11 +49,10 @@ This volume is dedicated to making the *experience* of [**assistive technology**]() users more **comfortable** and **immersive**. @Image(source: volume-2.png, alt: "") - @Chapter(name: "Accessible description") { + @Chapter(name: "Accessible content") { @Image(source: chapter-2-1.png, alt: "") **Describe the accessible interface** to that extent so its users have **less ambiguity in its interpretation**. - @TutorialReference(tutorial: "doc:AccessibleUX") @TutorialReference(tutorial: "doc:AccessibleCharts") @TutorialReference(tutorial: "doc:AccessibleListening") @TutorialReference(tutorial: "doc:AccessibleReading") @@ -62,10 +61,12 @@ @Chapter(name: "Accessible controls") { Implement **advanced alternative accessible controlling options** to make the experience **smoother**. - @TutorialReference(tutorial: "doc:Rotor") - @TutorialReference(tutorial: "doc:CustomRotor") - @TutorialReference(tutorial: "doc:CustomActions") + @TutorialReference(tutorial: "doc:AdjustableElements") + @TutorialReference(tutorial: "doc:Frame") + @TutorialReference(tutorial: "doc:Haptics") @TutorialReference(tutorial: "doc:KeyboardShortcuts") + @TutorialReference(tutorial: "doc:ControlHierarchy") + @TutorialReference(tutorial: "doc:Traits") @Image(source: chapter-2-2.png, alt: "") } @@ -75,20 +76,22 @@ Develop **sufficient paths** to enable people **conveniently complete the tasks** they are supposed to. @TutorialReference(tutorial: "doc:HorizontalSwipes") - @TutorialReference(tutorial: "doc:aVerticalSwipes") - @TutorialReference(tutorial: "doc:AdjustableElements") - @TutorialReference(tutorial: "doc:HideUselessControls") - @TutorialReference(tutorial: "doc:TextInput") - @TutorialReference(tutorial: "doc:ErrorPrevention") + @TutorialReference(tutorial: "doc:Notifications") + @TutorialReference(tutorial: "doc:VerticalSwipes") + @TutorialReference(tutorial: "doc:CustomActions") + @TutorialReference(tutorial: "doc:CustomRotor") + @TutorialReference(tutorial: "doc:Containers") + @TutorialReference(tutorial: "doc:Error-Handling") } - @Chapter(name: "Accessible appearance") { + @Chapter(name: "Visual accessibility") { @Image(source: chapter-2-4.png, alt: "") Make your **GUI easier to be visually comprehended** for people with **visual** or **mental impairments**. - @TutorialReference(tutorial: "doc:ColorsAndShapes") - @TutorialReference(tutorial: "doc:AdaptedPrivacy") + @TutorialReference(tutorial: "doc:ColoursAndShapes") + @TutorialReference(tutorial: "doc:InterfaceScale") + @TutorialReference(tutorial: "doc:ReduceMotion") } } @@ -103,11 +106,8 @@ Get familiar with the ideas and **reasoning behind accessibility**. - @TutorialReference(tutorial: "doc:Processes") @TutorialReference(tutorial: "doc:Standarts") - @TutorialReference(tutorial: "doc:Privacy") @TutorialReference(tutorial: "doc:AccessibleDesign") - @TutorialReference(tutorial: "doc:AccessibilityTree") @TutorialReference(tutorial: "doc:VoiceOverDesigner") } @@ -124,7 +124,6 @@ @TutorialReference(tutorial: "doc:SnapshotTesting") @TutorialReference(tutorial: "doc:UITesting") @TutorialReference(tutorial: "doc:Manual") - @TutorialReference(tutorial: "doc:GuidedAccess") } @Chapter(name: "Activism") { diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleCharts/AccessibleCharts.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleCharts/AccessibleCharts.tutorial new file mode 100644 index 0000000..fff15f0 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleCharts/AccessibleCharts.tutorial @@ -0,0 +1,38 @@ +@Tutorial(time: 20) { + @Intro(title: "Adapting Visual Data Representation") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @Section(title: "Data charts") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } + @Section(title: "Charts description") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } + @Section(title: "Audio graphs") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleListening/AccessibleListening.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleListening/AccessibleListening.tutorial new file mode 100644 index 0000000..688b6a2 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleListening/AccessibleListening.tutorial @@ -0,0 +1,65 @@ +@Article(time: 20) { + @Intro(title: "Accessibility of Audio Content") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Hearing impairments + ## Optionality + + ### Don't play sound by default + ### Silent mode + ### Volume adjustment + + ## Scripts + + ## Captions + + ## Sign-language + } +} + +@Comment { + @Tutorial(time: 10) { + @Intro(title: "Adapting Audial Content") { + An application may contain as many sounds as a person without hearing impairments can imagine. Sound notifications, reactions, background music, content with an audial channel - everything that plays a crucial role in perceiving a "sound" application may be neglected. If not by a hearing impairment, then by an assistive technology that adds more information to the auidial layer. So let's see how to make sounds accessible for everyone. + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + + @Comment { + https://developer.apple.com/wwdc20/10022 + Intro + Task + https://www.apple.com/newsroom/2024/03/apple-introduces-transcripts-for-apple-podcasts/ + AVSpeechSynthesizer + Cases + Wrap-up + Quiz + } + + @Section(title: "<#text#>") { + @ContentAndMedia { + <#text#> + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + + @Steps { + @Step { + <#text#> + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + + @Step { + <#text#> + + @Code(name: "<#display name#>", file: <#filename.swift#>) + } + } + } + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleReading/AccessibleReading.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleReading/AccessibleReading.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleReading/AccessibleReading.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AccessibleReading/AccessibleReading.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AlternativeDescription/AlternativeDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AlternativeDescription/AlternativeDescription.tutorial new file mode 100644 index 0000000..640d39f --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/AlternativeDescription/AlternativeDescription.tutorial @@ -0,0 +1,59 @@ +@Article(time: 30) { + @Intro(title: "Alternative Description") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Vision impairments + + ## Enhance visual properties + + ## Alternative description + + ## Video captioning + } +} + +@Comment { + @Tutorial(time: 15) { + + @Comment { + https://meryl.net/captioned-videos-complete-guide/ + } + + @Intro(title: "Visual Content Captioning") { + Not only functional images such as interface controls require textual description. Images that are purely decorative are also inaccessible for people who have no ability to see them. So let's dive into the art of translating visual experience and allow everyone to enjoy pictures, animations and videos in your app. + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + + @Comment { + Intro + Task + AI + Purpose + Process + Details + Quiz + } + + + @Section(title: "<#text#>") { + @ContentAndMedia { + <#text#> + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + + @Steps { + @Step { + <#text#> + + @Image(source: <#file#>, alt: "<#accessible description#>") + } + } + } + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/butterfly.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/butterfly.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/butterfly.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/butterfly.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/color-blindness.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/color-blindness.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/color-blindness.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/color-blindness.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/earth.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/earth.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/earth.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/earth.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/eye-injury.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/eye-injury.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/eye-injury.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/eye-injury.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/eyes.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/eyes.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/eyes.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/eyes.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/fish.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/fish.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/fish.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/fish.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/frogs.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/frogs.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/frogs.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/frogs.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/magnifying-glass.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/magnifying-glass.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/magnifying-glass.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/magnifying-glass.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/newborn-albino.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/newborn-albino.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/newborn-albino.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/newborn-albino.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/senses.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/senses.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/senses.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/senses.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/senses~dark.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/senses~dark.png similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Resources/senses~dark.png rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleContent/Resources/senses~dark.png diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial index 9bcad93..fd91855 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/AdjustableElements.tutorial @@ -1,107 +1,192 @@ +@Tutorial(time: 30) { + @Intro(title: "VoiceOver Extraneous Description") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @Section(title: "Accessibility value") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } + + @Section(title: "Adjustable elements") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } + + @Section(title: "Wrap-up") { + @ContentAndMedia { + Text + } + @Steps { + @Step { + An instructional sentence + } + } + } +} -@Tutorial(time: 10) { - @Intro(title: "Setting Up Adjustable Elements") { +@Comment { Simplifies interactions with complex elements for VoiceOver. + + > Tip: + > - Best for VoiceOver, is changed by vertical swipe + > - Avoid at Voice Control + > - Replace by ``Book/accessibilityNavigationStyle`` for Switch Control + + ## Overview + + By default any element can contain ``UIAccessibilityTraits_/adjustable`` trait to expose additional data for user. Some elements come complicated and can contain dynamic value, controlled by vertical swipe. Examples: + - Slider + - Stepper + - Any horizontal carousel + + > Note: After vertical swipe reads only the new value, a label is omitted to avoid repeatness. + + Tutorial for detailed explanation. + + ### How to setup + + - Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. + - As a result the element will react on vertical swipe by calling ``Book/accessibilityIncrement()`` and ``Book/accessibilityDecrement()``. + - After each swipe the ``Book/accessibilityValue`` getter will be reread and the new value will be spoken out. + + ### Enable adjustable only for VoiceOver + + > Important: Adjustable elements is useful only for VoiceOver and will brake behaviour for Voice Control and Switch Control. + + Distinguish behaviour in code by dynamic getter: + + ``` + var isAccessibilityElement: Bool { + UIAccessibility.isVoiceOverRunning + } + + var accessibilityTraits: UIAccessibilityTraits { + if UIAccessibility.isVoiceOverRunning { + return [.adjustable] + } else { + return .none + } + } + ``` + + ### Selection follow focus + + @Comment { + // TODO: Selection follow focus + // TODO: Visual Samples + } + + ### `button` and `adjustable` + + @Comment { + // TODO: Stories sample + } + + ### Tutorial + + See tutorial } +} +@Comment { + @Section(title: "Basic Setup") { + @ContentAndMedia { + By default any element can contain ``Book/accessibilityValue`` to expose *additional data* to user. Some elements come complicated and may contain a *dynamic value* controlled by a vertical swipe. Here some examples: + } - - @Section(title: "Title") { - Jepa. @Steps { @Step { - Jepa. - @Image(source: placeholder-image.png, alt: "") + Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. + + @Code(name: "", file: "AdjustableTutorialStep_1.swift") + } + + @Step { + Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. + + @Code(name: "", file: "AdjustableTutorialStep_2.swift") + } + + @Step {` + As a result the element will react on a vertical swipe by calling ``Book/accessibilityIncrement()`` and ``Book/accessibilityDecrement()``. + + After each swipe the ``Book/accessibilityValue`` getter will be read again and the next value will be vocalised. + + > Note: `AccessibilityLabel wouldn't be read again after swipe` + + @Code(name: "", file: "AdjustableTutorialStep_3.swift") } } } - @Comment { - @Section(title: "Basic Setup") { - @ContentAndMedia { - By default any element can contain ``Book/accessibilityValue`` to expose *additional data* to user. Some elements come complicated and may contain a *dynamic value* controlled by a vertical swipe. Here some examples: + @Section(title: "Backward Compatibility") { + @ContentAndMedia { + Voice Control and Switch Control work with separate *buttons* instead of *adjustable elements*. + } + + @Steps { + @Step { + > Important: Adjustable elements are only used for VoiceOver and will break the behaviour of Voice Control and Switch Control. + + Distinguish their behaviour in code by a dynamic getter: + + @Code(name: "", file: "AdjustableTutorialStep_4.swift") } - @Steps { - @Step { - Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. - - @Code(name: "", file: "AdjustableTutorialStep_1.swift") - } + @Step { + Switch Control requires grouping: firstly focus will be placed on the group itself, afterwards the selection will be moved between elements of this group. It simulates navigation by reducing the number of elements on each level. - @Step { - Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. - - @Code(name: "", file: "AdjustableTutorialStep_2.swift") - } + > Note: Watch video [How Grouping Simplifies Navigation](https://youtube.com/shorts/1l8H615EkV0?si=tKyhIGjBbR9XG9HP) - @Step {` - As a result the element will react on a vertical swipe by calling ``Book/accessibilityIncrement()`` and ``Book/accessibilityDecrement()``. - - After each swipe the ``Book/accessibilityValue`` getter will be read again and the next value will be vocalised. - - > Note: `AccessibilityLabel wouldn't be read again after swipe` - - @Code(name: "", file: "AdjustableTutorialStep_3.swift") - } + @Code(name: "", file: "AdjustableTutorialStep_5.swift") } } - - @Section(title: "Backward Compatibility") { - @ContentAndMedia { - Voice Control and Switch Control work with separate *buttons* instead of *adjustable elements*. - } - - @Steps { - @Step { - > Important: Adjustable elements are only used for VoiceOver and will break the behaviour of Voice Control and Switch Control. - - Distinguish their behaviour in code by a dynamic getter: - - @Code(name: "", file: "AdjustableTutorialStep_4.swift") - } + } + + @Assessments { + @MultipleChoice { + What **Accessibility Features** use adjustable trait? + + @Choice(isCorrect: false) { + Switch Control + - @Step { - Switch Control requires grouping: firstly focus will be placed on the group itself, afterwards the selection will be moved between elements of this group. It simulates navigation by reducing the number of elements on each level. - - > Note: Watch video [How Grouping Simplifies Navigation](https://youtube.com/shorts/1l8H615EkV0?si=tKyhIGjBbR9XG9HP) - - @Code(name: "", file: "AdjustableTutorialStep_5.swift") + @Justification(reaction: "Try again!") { + Switch Control indeed requires grouping to simplify navigation, but uses ``Book/accessibilityNavigationStyle`` for that. } } - } - - @Assessments { - @MultipleChoice { - What **Accessibility Features** use adjustable trait? - - @Choice(isCorrect: false) { - Switch Control - - - @Justification(reaction: "Try again!") { - Switch Control indeed requires grouping to simplify navigation, but uses ``Book/accessibilityNavigationStyle`` for that. - } + + @Choice(isCorrect: true) { + VoiceOver + + + @Justification(reaction: "That's right!") { + Blind people would like to have a reduced number of elements on the screen and simplified interactions by vertical swipes to adjust the value of the element. } - - @Choice(isCorrect: true) { - VoiceOver - + } - @Justification(reaction: "That's right!") { - Blind people would like to have a reduced number of elements on the screen and simplified interactions by vertical swipes to adjust the value of the element. - } - } + @Choice(isCorrect: false) { + Voice Control - @Choice(isCorrect: false) { - Voice Control - - - @Justification(reaction: "Try again!") { - Voice Control is mostly used by people who are able to see. In such case perceiving elements as separate buttons is preferred. - } + + @Justification(reaction: "Try again!") { + Voice Control is mostly used by people who are able to see. In such case perceiving elements as separate buttons is preferred. } } } } } - diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial deleted file mode 100644 index 2b09d4e..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial +++ /dev/null @@ -1,68 +0,0 @@ -@Article(time: 20) { - - @Intro(title: "Adjustable Elements") { - } - @Comment { - Simplifies interactions with complex elements for VoiceOver. - - > Tip: - > - Best for VoiceOver, is changed by vertical swipe - > - Avoid at Voice Control - > - Replace by ``Book/accessibilityNavigationStyle`` for Switch Control - - ## Overview - - By default any element can contain ``UIAccessibilityTraits_/adjustable`` trait to expose additional data for user. Some elements come complicated and can contain dynamic value, controlled by vertical swipe. Examples: - - Slider - - Stepper - - Any horizontal carousel - - > Note: After vertical swipe reads only the new value, a label is omitted to avoid repeatness. - - Tutorial for detailed explanation. - - ### How to setup - - - Accessible element can be marked by ``UIAccessibilityTraits_/adjustable`` trait to make ``Book/accessibilityValue`` dynamic. - - As a result the element will react on vertical swipe by calling ``Book/accessibilityIncrement()`` and ``Book/accessibilityDecrement()``. - - After each swipe the ``Book/accessibilityValue`` getter will be reread and the new value will be spoken out. - - ### Enable adjustable only for VoiceOver - - > Important: Adjustable elements is useful only for VoiceOver and will brake behaviour for Voice Control and Switch Control. - - Distinguish behaviour in code by dynamic getter: - - ``` - var isAccessibilityElement: Bool { - UIAccessibility.isVoiceOverRunning - } - - var accessibilityTraits: UIAccessibilityTraits { - if UIAccessibility.isVoiceOverRunning { - return [.adjustable] - } else { - return .none - } - } - ``` - - ### Selection follow focus - - @Comment { - // TODO: Selection follow focus - // TODO: Visual Samples - } - - ### `button` and `adjustable` - - @Comment { - // TODO: Stories sample - } - - ### Tutorial - - See tutorial - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/ErrorPrevention/ErrorPrevention.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/ErrorPrevention/ErrorPrevention.tutorial deleted file mode 100644 index ff17626..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/ErrorPrevention/ErrorPrevention.tutorial +++ /dev/null @@ -1,5 +0,0 @@ -@Article(time: 20) { - @Intro(title: "Accessible Mistakes Correction") { - FUCK time limits - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Frame/Frame.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Frame/Frame.tutorial index 9e9e8e1..1e30952 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Frame/Frame.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Frame/Frame.tutorial @@ -1,28 +1,17 @@ -@Tutorial(time: 10) { +@Tutorial(time: 30) { @Intro(title: "Activation Point Constraints") { - <#text#> + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Frame") { @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") + Text } - @Steps { @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) + An instructional sentence } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Haptics/Haptics.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Haptics/Haptics.tutorial new file mode 100644 index 0000000..7b8d545 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Haptics/Haptics.tutorial @@ -0,0 +1,12 @@ +@Article(time: 15) { + @Intro(title: "Haptic Feedback") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Haptics + ## Notifications + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Input/TextInput.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Input/TextInput.tutorial deleted file mode 100644 index f3ba69c..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Input/TextInput.tutorial +++ /dev/null @@ -1,17 +0,0 @@ -@Tutorial(time: 20) { - @Intro(title: "How Text Input Works") { - - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/KeyboardShortcuts/KeyboardShortcuts.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/KeyboardShortcuts/KeyboardShortcuts.tutorial index 2d8e778..6bb0dee 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/KeyboardShortcuts/KeyboardShortcuts.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/KeyboardShortcuts/KeyboardShortcuts.tutorial @@ -1,28 +1,20 @@ @Tutorial(time: 15) { @Intro(title: "Full Keyboard Access Shortcuts") { - <#text#> + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) + An instructional message. } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Rotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Rotor.tutorial deleted file mode 100644 index 7434a49..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Rotor.tutorial +++ /dev/null @@ -1,18 +0,0 @@ -@Tutorial(time: 30) { - @Intro(title: "Default Actions With Rotor") { - @Image(source: rotor-safari, alt: "") - - } - - @Section(title: "<#text#>") { - - @ContentAndMedia { - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/addTraits.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/addTraits.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/addTraits.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/addTraits.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/allowsDirectTouch.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/allowsDirectTouch.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/allowsDirectTouch.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/allowsDirectTouch.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/budgetSlider.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/budgetSlider.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/budgetSlider.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/budgetSlider.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/isToggle.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/isToggle.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/SwiftUI/isToggle.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/SwiftUI/isToggle.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/directTouch.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/directTouch.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/directTouch.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/directTouch.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/hiddenTraits.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/hiddenTraits.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/hiddenTraits.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/hiddenTraits.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/optionSet.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/optionSet.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/optionSet.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/optionSet.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/toggleButton.swift b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/toggleButton.swift similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Code/UIKit/toggleButton.swift rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Code/UIKit/toggleButton.swift diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/adjustable.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/adjustable.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/adjustable.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/adjustable.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/adjustable~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/adjustable~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/adjustable~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/adjustable~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/buttons.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/buttons.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/buttons.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/buttons.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/buttons~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/buttons~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/buttons~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/buttons~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/controls.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/controls.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/controls.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/controls.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/controls~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/controls~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/controls~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/controls~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/direct-interaction.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/direct-interaction.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/direct-interaction.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/direct-interaction.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/direct-interaction~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/direct-interaction~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/direct-interaction~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/direct-interaction~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/headers.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/headers.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/headers.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/headers.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/images.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/images.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/images.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/images.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/images~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/images~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/images~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/images~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/keys.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/keys.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/keys.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/keys.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/links.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/links.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/links.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/links.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/media-session.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/media-session.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/media-session.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/media-session.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/modal.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/modal.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/modal.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/modal.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/modal~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/modal~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/modal~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/modal~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/not-enabled.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/not-enabled.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/not-enabled.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/not-enabled.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/plays-sound.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/plays-sound.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/plays-sound.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/plays-sound.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/search-field.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/search-field.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/search-field.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/search-field.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/search-field~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/search-field~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/search-field~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/search-field~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/selected.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/selected.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/selected.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/selected.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/selected~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/selected~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/selected~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/selected~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/static-text.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/static-text.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/static-text.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/static-text.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/static-text~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/static-text~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/static-text~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/static-text~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/summary-element.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/summary-element.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/summary-element.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/summary-element.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/tabs.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/tabs.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/tabs.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/tabs.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/tabs~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/tabs~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/tabs~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/tabs~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/toggles.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/toggles.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/toggles.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/toggles.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/toggles~dark.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/toggles~dark.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/toggles~dark.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/toggles~dark.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/updates-frequently.PNG b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/updates-frequently.PNG similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Images/updates-frequently.PNG rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Images/updates-frequently.PNG diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Traits.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Traits.tutorial similarity index 99% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Traits.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Traits.tutorial index 9debfa1..41cc349 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/Traits/Traits.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleControls/Traits/Traits.tutorial @@ -1,4 +1,4 @@ -@Tutorial(time: 15) { +@Tutorial(time: 30) { @Comment { https://developer.apple.com/documentation/swiftui/accessibilitytraits swiftui cyka @@ -389,7 +389,7 @@ @Section(title: "Static Text") { @ContentAndMedia { - Static Text element is an element that is just a text and has possible interactions. Use it to explicitly state that the item cannot be activated and is purely decorative. Moreover, setting this trait tells that there is no need to check on the element afterwards: it won't change. + Static Text element is an element that is just a text and has possible interactions. Use it to explicitly state that the item cannot be activated and is purely decorative. Moreover, setting this trait tells Accessibility API that there is no need to check on the element afterwards: it won't change. @Image(source: static-text, alt: "") } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial deleted file mode 100644 index f3e57d7..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleCharts/AccessibleCharts.tutorial +++ /dev/null @@ -1,23 +0,0 @@ -@Tutorial(time: 20) { - - @Comment { - миш тут я справлюсь на самом деле учитывая что это все есть в книге и презентация и есть ввдс презентация ИСКЛЮЧИТЕЛЬНО про чарты - https://developer.apple.com/wwdc21/10122 - } - - @Intro(title: "Making Charts Accessible") { - - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial deleted file mode 100644 index 150d764..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AccessibleListening/AccessibleListening.tutorial +++ /dev/null @@ -1,40 +0,0 @@ -@Tutorial(time: 10) { - @Intro(title: "Adapting Audial Content") { - An application may contain as many sounds as a person without hearing impairments can imagine. Sound notifications, reactions, background music, content with an audial channel - everything that plays a crucial role in perceiving a "sound" application may be neglected. If not by a hearing impairment, then by an assistive technology that adds more information to the auidial layer. So let's see how to make sounds accessible for everyone. - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Comment { - https://developer.apple.com/wwdc20/10022 - Intro - Task - https://www.apple.com/newsroom/2024/03/apple-introduces-transcripts-for-apple-podcasts/ - AVSpeechSynthesizer - Cases - Wrap-up - Quiz - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial deleted file mode 100644 index 6a15fe8..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleDescription/AlternativeDescription/AlternativeDescription.tutorial +++ /dev/null @@ -1,39 +0,0 @@ -@Tutorial(time: 15) { - - @Comment { - https://meryl.net/captioned-videos-complete-guide/ - } - - @Intro(title: "Visual Content Captioning") { - Not only functional images such as interface controls require textual description. Images that are purely decorative are also inaccessible for people who have no ability to see them. So let's dive into the art of translating visual experience and allow everyone to enjoy pictures, animations and videos in your app. - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Comment { - Intro - Task - AI - Purpose - Process - Details - Quiz - } - - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Containers.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Containers.tutorial index 6030ec0..aad6bd3 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Containers.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Containers.tutorial @@ -1,28 +1,20 @@ -@Tutorial(time: 20) { - @Intro(title: "Containers") { - <#text#> +@Tutorial(time: 15) { + @Intro(title: "Accessibility Containers") { + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) + An instructional message. } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/aControlHierarchy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/ControlHierarchy.tutorial similarity index 98% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/aControlHierarchy.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/ControlHierarchy.tutorial index 52bd891..c041eda 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/aControlHierarchy.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/ControlHierarchy.tutorial @@ -1,8 +1,9 @@ @Article(time: 20) { - @Intro(title: "Control Hierarchy") { + @Intro(title: "Controls Hierarchy") { } } + @Comment { ## Overview diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomActions.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomActions.tutorial index 17cd465..19f7835 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomActions.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomActions.tutorial @@ -1,16 +1,20 @@ -@Tutorial(time: 20) { +@Tutorial(time: 15) { @Intro(title: "Custom Actions") { + Здесь зачин. + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. + + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#Work in progress#> + An instructional message. } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomRotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomRotor.tutorial index 05023a2..52bcdef 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomRotor.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/CustomRotor.tutorial @@ -1,16 +1,20 @@ @Tutorial(time: 20) { @Intro(title: "Custom Rotor") { + Здесь зачин. + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { + @Section(title: "Title") { @ContentAndMedia { - <#text#> + Text. + + @Image(source: placeholder-image, alt: "") } @Steps { @Step { - <#Work in progress#> + An instructional message. } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Error-Handling/Error-Handling.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Error-Handling/Error-Handling.tutorial new file mode 100644 index 0000000..70ba887 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Error-Handling/Error-Handling.tutorial @@ -0,0 +1,16 @@ +@Article(time: 45) { + @Intro(title: "Accessible Error-Handling") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Human design + ## Assistive-technology + ## Input forms + ## Action confirmation + ## Undoing actions + ## Confidential data privacy + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Haptics.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Haptics.tutorial deleted file mode 100644 index 221fa9a..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Haptics.tutorial +++ /dev/null @@ -1,29 +0,0 @@ -@Tutorial(time: 10) { - @Intro(title: "Haptic Feedback") { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HideUselessControls.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HideUselessControls.tutorial deleted file mode 100644 index 0fdf595..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HideUselessControls.tutorial +++ /dev/null @@ -1,17 +0,0 @@ -@Tutorial(time: 10) { - @Intro(title: "Hide Excessive Controls") { - Only he knows what is supposed to be here. - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HorizontalSwipes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HorizontalSwipes.tutorial index b7a5220..ff70055 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HorizontalSwipes.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/HorizontalSwipes.tutorial @@ -1,29 +1,12 @@ -@Tutorial(time: 30) { +@Article(time: 15) { @Intro(title: "Horizontal Swipes") { - <#text#> + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } + @ContentAndMedia { + ## Item selection + ## Accessible scroll } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Notifications.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Notifications.tutorial index 4b09933..3313ed3 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Notifications.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/Notifications.tutorial @@ -1,29 +1,11 @@ -@Tutorial(time: 20) { - @Intro(title: "Accessible Notifications") { - <#text#> +@Article(time: 15) { + @Intro(title: "Notifications") { + Здесь зачин. - @Image(source: <#file#>, alt: "<#accessible description#>") + @Image(source: placeholder-image, alt: "") } - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } + @ContentAndMedia { + Some header here. } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial deleted file mode 100644 index 9460e1f..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial +++ /dev/null @@ -1,17 +0,0 @@ -@Tutorial(time: 20) { - @Intro(title: "Accessible Elements Hierarchy") { - - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial deleted file mode 100644 index 325b4be..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial +++ /dev/null @@ -1,17 +0,0 @@ -@Tutorial(time: 20) { - @Intro(title: "Focus Management") { - - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/On-ScreenNavigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/On-ScreenNavigation.tutorial new file mode 100644 index 0000000..ce40596 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/On-ScreenNavigation.tutorial @@ -0,0 +1,11 @@ +@Article(time: 15) { + @Intro(title: "On-Screen Navigation") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + Some header here. + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial deleted file mode 100644 index 0e9c7e0..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial +++ /dev/null @@ -1,17 +0,0 @@ -@Tutorial(time: 15) { - @Intro(title: "Iterating Elements within a Screen") { - - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/VerticalSwipes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/VerticalSwipes.tutorial new file mode 100644 index 0000000..d109e47 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/VerticalSwipes.tutorial @@ -0,0 +1,14 @@ +@Article(time: 15) { + @Intro(title: "Vertical Swipes") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Additional information + ## Variable actions + ## Rotor + ## Text input + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/aVerticalSwipes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/aVerticalSwipes.tutorial deleted file mode 100644 index 07536da..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/aVerticalSwipes.tutorial +++ /dev/null @@ -1,33 +0,0 @@ -@Article(time: 20) { - @Intro(title: "Vertical Swipes") { - Vertical swipe have a lot of possible actions and all of them depends on focus'es context. - - ## Overview - - Previously we discussed how to add vertical swipe to any element at and . But vertical swipe is so easy to do and can have a lot of other actions. - - ### Custom action - - Context actions - - #### Custom action in Voice Control and Switch Control - - Provide icon - - ### Custom description - - Secondary description - - ### Rotor - - Choose action for vertical swipe - - ### Navigation - - A lot of navigation model - - ### Text input - - See - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColorsAndShapes/ColorsAndShapes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColorsAndShapes/ColorsAndShapes.tutorial deleted file mode 100644 index f2eceb4..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColorsAndShapes/ColorsAndShapes.tutorial +++ /dev/null @@ -1,180 +0,0 @@ -@Tutorial(time: 15) { - @Intro(title: "Colors and Shapes") { - это для сотрудников арт лебедев - @Image(source: visual-properties, alt: "") - @Comment { - https://support.apple.com/en-us/111773 - https://www.whocanuse.com - https://www.funkify.org - https://wise.design - https://www.oxo.com - спиздить у кирилла слайд про мужиков - https://www.figma.com/file/i3Xh0rnBgNTqlPbRKO3aYc/Apple-Design-Resources-–-iOS-17-and-iPadOS-17-(Community)?type=design&node-id=0-2194&mode=design&t=PkyE043rZ0FZtHNs-0 - } - } - - - - > Note: Accessibility Inspector has a built-in instrument - - - @Section(title: "Accessible Appearance of Controls") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } - - @Section(title: "Dark Mode Support") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } - - @Section(title: "Color Blindness") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } - - @Section(title: "Sufficient Contrast") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } - - @Section(title: "Dynamic Type") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } - - @Section(title: "What now") { - @ContentAndMedia { - Congratulations! - - What about a little `quiz` to revise the topic? 🔎 - - @Image(source: placeholder-image, alt: "") - } - - @Steps { - @Step { - Text. - @Image(source: placeholder-image, alt: "") - } - } - } - @Assessments { - @MultipleChoice { - Question? - - @Choice(isCorrect: false) { - Yes - @Justification(reaction: "Try again!") { - text - } - } - - @Choice(isCorrect: true) { - No - @Justification(reaction: "That's right!") { - text - } - } - - @Choice(isCorrect: false) { - Maybe - @Justification(reaction: "Try again!") { - text - } - } - } - - @MultipleChoice { - Question? - - @Choice(isCorrect: false) { - Yes - @Justification(reaction: "Try again!") { - text - } - } - - @Choice(isCorrect: true) { - No - @Justification(reaction: "That's right!") { - text - } - } - - @Choice(isCorrect: false) { - Maybe - @Justification(reaction: "Try again!") { - text - } - } - } - - @MultipleChoice { - Question? - - @Choice(isCorrect: false) { - Yes - @Justification(reaction: "Try again!") { - text - } - } - - @Choice(isCorrect: false) { - No - @Justification(reaction: "Try again!") { - text - } - } - - @Choice(isCorrect: true) { - All - @Justification(reaction: "That's right!") { - text - } - } - - @Choice(isCorrect: false) { - None - @Justification(reaction: "Try again!") { - text - } - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColoursAndShapes/ColoursAndShapes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColoursAndShapes/ColoursAndShapes.tutorial new file mode 100644 index 0000000..ece58cc --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ColoursAndShapes/ColoursAndShapes.tutorial @@ -0,0 +1,198 @@ +@Article(time: 15) { + @Intro(title: "ColoursAndShapes") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Colour blindness + ## Distinguish by both colour and shape + ## Sufficient contrast + ## Dark mode + ## Dynamic Type + } +} + +@Comment { + @Tutorial(time: 15) { + @Intro(title: "Colors and Shapes") { + это для сотрудников арт лебедев + @Image(source: visual-properties, alt: "") + @Comment { + https://support.apple.com/en-us/111773 + https://www.whocanuse.com + https://www.funkify.org + https://wise.design + https://www.oxo.com + спиздить у кирилла слайд про мужиков + https://www.figma.com/file/i3Xh0rnBgNTqlPbRKO3aYc/Apple-Design-Resources-–-iOS-17-and-iPadOS-17-(Community)?type=design&node-id=0-2194&mode=design&t=PkyE043rZ0FZtHNs-0 + } + } + + + + > Note: Accessibility Inspector has a built-in instrument + + + @Section(title: "Accessible Appearance of Controls") { + @ContentAndMedia { + <#text#> + } + + @Steps { + @Step { + <#Work in progress#> + } + } + } + + @Section(title: "Dark Mode Support") { + @ContentAndMedia { + <#text#> + } + + @Steps { + @Step { + <#Work in progress#> + } + } + } + + @Section(title: "Color Blindness") { + @ContentAndMedia { + <#text#> + } + + @Steps { + @Step { + <#Work in progress#> + } + } + } + + @Section(title: "Sufficient Contrast") { + @ContentAndMedia { + <#text#> + } + + @Steps { + @Step { + <#Work in progress#> + } + } + } + + @Section(title: "Dynamic Type") { + @ContentAndMedia { + <#text#> + } + + @Steps { + @Step { + <#Work in progress#> + } + } + } + + @Section(title: "What now") { + @ContentAndMedia { + Congratulations! + + What about a little `quiz` to revise the topic? 🔎 + + @Image(source: placeholder-image, alt: "") + } + + @Steps { + @Step { + Text. + @Image(source: placeholder-image, alt: "") + } + } + } + @Assessments { + @MultipleChoice { + Question? + + @Choice(isCorrect: false) { + Yes + @Justification(reaction: "Try again!") { + text + } + } + + @Choice(isCorrect: true) { + No + @Justification(reaction: "That's right!") { + text + } + } + + @Choice(isCorrect: false) { + Maybe + @Justification(reaction: "Try again!") { + text + } + } + } + + @MultipleChoice { + Question? + + @Choice(isCorrect: false) { + Yes + @Justification(reaction: "Try again!") { + text + } + } + + @Choice(isCorrect: true) { + No + @Justification(reaction: "That's right!") { + text + } + } + + @Choice(isCorrect: false) { + Maybe + @Justification(reaction: "Try again!") { + text + } + } + } + + @MultipleChoice { + Question? + + @Choice(isCorrect: false) { + Yes + @Justification(reaction: "Try again!") { + text + } + } + + @Choice(isCorrect: false) { + No + @Justification(reaction: "Try again!") { + text + } + } + + @Choice(isCorrect: true) { + All + @Justification(reaction: "That's right!") { + text + } + } + + @Choice(isCorrect: false) { + None + @Justification(reaction: "Try again!") { + text + } + } + } + } + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/DynamicType.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/InterfaceScale.tutorial similarity index 98% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/DynamicType.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/InterfaceScale.tutorial index 9f0619a..e728e65 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/DynamicType.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/DynamicType/InterfaceScale.tutorial @@ -1,5 +1,5 @@ @Tutorial(time: 30) { - @Intro(title: "Interface Scale with Dynamic Type") { + @Intro(title: "Interface Scale") { 7 РАЗМЕРОВ ШРИФТА ДЛЯ ПЕРЕБИРАНИЯ ХАРЧАМИ, 5 ДЛЯ ТЕХ КОМУ РЕАЛЬНО НАДО diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/Privacy/Privacy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/Privacy/Privacy.tutorial deleted file mode 100644 index e47a495..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/Privacy/Privacy.tutorial +++ /dev/null @@ -1,29 +0,0 @@ -@Tutorial(time: 15) { - @Intro(title: "Protecting Visual Confidential Data") { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReduceMotion/ReduceMotion.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReduceMotion/ReduceMotion.tutorial new file mode 100644 index 0000000..7341606 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReduceMotion/ReduceMotion.tutorial @@ -0,0 +1,17 @@ +@Article(time: 20) { + @Intro(title: "Reduce Motion") { + Здесь зачин. + + @Image(source: placeholder-image, alt: "") + } + + @ContentAndMedia { + ## Motion sickness + ## Cognitive impairments + ## Motion in an interface + ## Animations + ## Transitions + ## Video content + ## Reduced movement in games + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReducedMotion/ReducedMotion.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReducedMotion/ReducedMotion.tutorial deleted file mode 100644 index 0338d47..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/VisualAccessibility/ReducedMotion/ReducedMotion.tutorial +++ /dev/null @@ -1,103 +0,0 @@ -@Tutorial(time: 15) { - @Intro(title: "Reduced Motion") { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Section(title: "What is considered a movement") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } - - @Section(title: "Motion sickness and mental impairments") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } - - @Section(title: "Create a safe interface") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } - - @Section(title: "Limiting amount of animation") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } - - @Section(title: "Cross-fade transition") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } - - @Section(title: "Reduced movement in games") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Simplify/AdaptCells/AdaptCells.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Simplify/AdaptCells/AdaptCells.tutorial index a6d6be7..6a658f4 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Simplify/AdaptCells/AdaptCells.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Simplify/AdaptCells/AdaptCells.tutorial @@ -275,7 +275,7 @@ A regular swipe @Justification(reaction: "Try again!") { - Nope, ***vertical swipes* are used for *adjustable elements* and other operations**. + Nope, ***vertical swipes* are used for *adjustable elements* and other Rotor operations**. For example, **swipe from the *bottom* will close the current application**, the one **from the *top* will open Notifications Screen or Control Center**. } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AccessibilityFeatures.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AccessibilityFeatures.md index 9f2c94d..d248103 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AccessibilityFeatures.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AccessibilityFeatures.md @@ -73,7 +73,7 @@ In this book we're not going to take a precise look at each of them separately, - - - - - + - - } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AssistiveAccess/AssistiveAccess.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AssistiveAccess/AssistiveAccess.md index 998dce8..b0ba129 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AssistiveAccess/AssistiveAccess.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AssistiveAccess/AssistiveAccess.md @@ -73,7 +73,6 @@ To make an application **easy to operate** there are three directions to work on To learn more about *reasons* behind these guidelines visit our articles on the topic: @Links(visualStyle: list) { - - - - } @@ -112,4 +111,4 @@ Nevertheless, if **Apple** *decides* that they should invest their resources int - - - -- +- diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/aDynamicType.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/DynamicType.md similarity index 97% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/aDynamicType.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/DynamicType.md index 6609225..c1463b8 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/aDynamicType.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/DynamicType.md @@ -23,7 +23,7 @@ According to [**WHO**](https://www.who.int/news-room/fact-sheets/detail/blindnes @Image(source: twenty-five-percent, alt: "") -Talking about **Dynamic Type** we are going to discuss those **visual impairments** that affect the *sharpness* of the perceived picture. To learn more about **color blindness** or **major vision loss** visit [**Colors and Shapes**]() tutorial and [**VoiceOver**]() article accordingly. +Talking about **Dynamic Type** we are going to discuss those **visual impairments** that affect the *sharpness* of the perceived picture. To learn more about **color blindness** or **major vision loss** visit [**Colours and Shapes**]() tutorial and [**VoiceOver**]() article accordingly. @Row { @Column { diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial deleted file mode 100644 index e6ff68a..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial +++ /dev/null @@ -1,29 +0,0 @@ -@Tutorial(time: 20) { - @Intro(title: "Setting Up Guided Access") { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Steps { - @Step { - <#text#> - - @Image(source: <#file#>, alt: "<#accessible description#>") - } - - @Step { - <#text#> - - @Code(name: "<#display name#>", file: <#filename.swift#>) - } - } - } -} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/SwitchControl/SwitchControl.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/SwitchControl/SwitchControl.md index 8b0c297..b8432cc 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/SwitchControl/SwitchControl.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/SwitchControl/SwitchControl.md @@ -153,7 +153,6 @@ Support of Switch Control in accessible apps is represented by the accessible de ### Featured @Links(visualStyle: detailedGrid) { - - - } @@ -162,7 +161,6 @@ Support of Switch Control in accessible apps is represented by the accessible de ## See Also @Links(visualStyle: list) { - - - - - diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceOver/VoiceOver.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceOver/VoiceOver.md index 5de0620..9ac13b3 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceOver/VoiceOver.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceOver/VoiceOver.md @@ -152,5 +152,5 @@ Since supporting screen readers heavily relies on the **semantic structure** of - - - -- +- - diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/iOS Accessibility/iOSAccessibility.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/iOS Accessibility/iOSAccessibility.md index 5c1e59f..a0a7184 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/iOS Accessibility/iOSAccessibility.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/iOS Accessibility/iOSAccessibility.md @@ -82,7 +82,7 @@ To know more about *key features* -- those of our professional (as app creators) ## Wrap-up So, here we are. We came to the point where stating the **purpose of this book** is possible. - [**iOS Accessibility Handbook**](https://vodgroup.github.io/AccessibilityDocumentation/documentation/iosaccessibilityhandbook) is a collection of *guidelines* of how to create **iOS applications** that support [**Accessible Features**]() and promote [**inclusive design**](). + [**iOS Accessibility Handbook**](https://vodgroup.github.io/AccessibilityDocumentation/documentation/iosaccessibilityhandbook) is a collection of *guidelines* of how to create **iOS applications** that support [**Accessible Features**]() and promote [**inclusive design**](). @Image(source: human-interface-guidelines, alt: "A screenshot of Apple's Human Interface Guidelines web page") To dive right into the process of **developing accessible applications** don't hesitate to open the [**iOS Accessibility Guide**](https://vodgroup.github.io/AccessibilityDocumentation/tutorials/adaptionstrategy) map. *Everything* is there, you won't be left unprepared. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md index 402f2e1..7c0a871 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md @@ -92,8 +92,8 @@ Illustrative materials created exclusively for the book can be found [**here**]( - - - -- -- +- +- - - -