diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial index 64bbdf9..55858ce 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial @@ -105,14 +105,12 @@ Additional resources expanding on the topic of accessibility and its integration at various stages of the product's **life cycle**. - @Image(source: placeholder-image.png, alt: "") - @Chapter(name: "Design") { @Image(source: chapter-placeholder.png, alt: "") Get familiar with the ideas and **reasoning behind accessibility**. - + @TutorialReference(tutorial: "doc:AccessibleDesign") @TutorialReference(tutorial: "doc:AccessibilityTree") @TutorialReference(tutorial: "doc:VoiceOverDesigner") } @@ -123,6 +121,7 @@ **Tools** and **tactics** aimed to observe the accessibility of iOS applications. + @TutorialReference(tutorial: "doc:AccessibilityQualityAssurance") @TutorialReference(tutorial: "doc:AccessibilityChecklists") @TutorialReference(tutorial: "doc:AccessibilityInspector") @TutorialReference(tutorial: "doc:UnitTesting") @@ -145,7 +144,6 @@ Participate in the life of **a11y community** and advocate for accessibility outside of it. - @TutorialReference(tutorial: "doc:AccessibilityActivism") @TutorialReference(tutorial: "doc:AccessibilitySettingsStatistics") diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes/ColorsAndShapes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes/ColorsAndShapes.tutorial index 9efed0a..4b63bf5 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes/ColorsAndShapes.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes/ColorsAndShapes.tutorial @@ -2,13 +2,15 @@ @Intro(title: "Accessible Colors And Shapes") { это для сотрудников арт лебедев @Image(source: visual-properties, alt: "") - 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 + @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 + } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md deleted file mode 100644 index b952d4f..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md +++ /dev/null @@ -1,82 +0,0 @@ -# Adjustable Elements - -@Metadata { - @PageColor(blue) - @TitleHeading("Serves The Cause") - @PageImage( - purpose: icon, - source: "-", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Advanced Techniques") -} - -@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/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial new file mode 100644 index 0000000..2b09d4e --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial @@ -0,0 +1,68 @@ +@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/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md deleted file mode 100644 index f86451a..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md +++ /dev/null @@ -1,48 +0,0 @@ -# User scenarios for vertical swipes - -@Metadata { - @PageColor(blue) - @TitleHeading("Omnipotence") - @PageImage( - purpose: icon, - source: "vertical", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Advanced Techniques") -} - -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/Adaption/Advanced/AccessibleControls/aVerticalSwipes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.tutorial new file mode 100644 index 0000000..c5d5762 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.tutorial @@ -0,0 +1,33 @@ +@Article(time: 20) { + @Intro(title: "User scenarios for 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/Adaption/Basic/Connect/Navigation/Navigation.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/Navigation.tutorial similarity index 89% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/Navigation.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/Navigation.tutorial index 9678db7..93b1a28 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/Navigation.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/Navigation.tutorial @@ -1,22 +1,8 @@ -# Navigation - -@Metadata { - @PageColor(blue) - @TitleHeading("Lead The Way") - @PageImage( - purpose: icon, - source: "navigation", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Advanced Techniques") +@Article(time: 20) { + @Intro(title: "Navigation") { + + } } - @Comment { To simplify navigation developer had to achieve several goals: call a notification to update accessibility tree, manage focus when a new screen is opened, support action for closing or completing the screen. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.tutorial similarity index 85% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.tutorial index 7b1cb88..52bd891 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.tutorial @@ -1,22 +1,8 @@ -# Control Hierarchy - -@Metadata { - @PageColor(blue) - @TitleHeading("First Things First") - @PageImage( - purpose: icon, - source: "flowchart", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Advanced Techniques") +@Article(time: 20) { + @Intro(title: "Control Hierarchy") { + + } } - @Comment { ## Overview diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/MobileAccessibility.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/MobileAccessibility.md index 5ad796c..df96752 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/MobileAccessibility.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/MobileAccessibility.md @@ -118,16 +118,16 @@ The book's guidelines are structured *that* way so there is some **entry-level t @Image(source: book-content, alt: "") ### Course Plan -To see the *whole* curriculum visit the [**Table of Contents**](). +To see the *whole* curriculum visit the [**Table of Contents**](). @Image(source: roadmap, alt: "") ### Tutorials -To start right with **practicing** something new, go to [**Based**]() or [**Advanced**]() level heading pages according to what you want to learn. +To start right with **practicing** something new, go to [**Based**]() or [**Advanced**]() level heading pages according to what you want to learn. @Links(visualStyle: detailedGrid) { - - - - + - + - } ## Have fun! diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial index 07c0703..b602d76 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial @@ -1,4 +1,4 @@ -@Tutorial(time: 10) { +@Article(time: 10) { @Intro(title: "Making The World Accessible") { @Comment { @@ -7,16 +7,4 @@ } } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilitySettingsStatistics.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilitySettingsStatistics.tutorial index 16c2e6a..378959f 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilitySettingsStatistics.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilitySettingsStatistics.tutorial @@ -1,29 +1,5 @@ -@Tutorial(time: 15) { +@Article(time: 15) { @Intro(title: "Accessibility Settings Statistics") { <#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/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial index 7d602e1..2846caa 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibilityTree/AccessibilityTree.tutorial @@ -2,28 +2,5 @@ @Intro(title: "Controlling Accessibility With Accessibility Tree") { <#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/Enterprise/Design/AccessibleDesign.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibleDesign.md deleted file mode 100644 index ed59bc4..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibleDesign.md +++ /dev/null @@ -1,36 +0,0 @@ -# Accessible Design Guidelines - -@Comment { - https://inclusive.microsoft.design - https://inclusive.microsoft.design/tools-and-activities/Inclusive101Guidebook.pdf - - Designing inclusively doesn’t mean you’re - making one thing for all people. You’re - designing a diversity of ways for everyone - to participate in an experience with a sense - of belonging. - - https://developer.apple.com/wwdc21/10304 - https://developer.apple.com/wwdc21/10275 -} - -@Metadata { - @PageColor(blue) - @TitleHeading("Accessibility Enterprise") - @PageImage( - purpose: icon, - source: "outline", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Accessibility Production") -} - -Talking about iOS applications development support of Accessibility Features is not something extrinsic that comes from adaption but an immanent part of universal design. Building apps using UI frameworks natively suggests accessibility. Default structures used to build interfaces often include sufficient solutions for the elements to be accessible without developers intervention. But even if there is additional work on accessibility being done it something isn't enough for the application to be truly accessible. - -In this tutorial we're going to cover some of the aspects of apps design that are essential to be considered if you want your product to be accessible. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibleDesign.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibleDesign.tutorial new file mode 100644 index 0000000..34e271a --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/AccessibleDesign.tutorial @@ -0,0 +1,22 @@ + +@Comment { + https://inclusive.microsoft.design + https://inclusive.microsoft.design/tools-and-activities/Inclusive101Guidebook.pdf + + Designing inclusively doesn’t mean you’re + making one thing for all people. You’re + designing a diversity of ways for everyone + to participate in an experience with a sense + of belonging. + + https://developer.apple.com/wwdc21/10304 + https://developer.apple.com/wwdc21/10275 +} + +@Article(time: 40) { + @Intro(title: "Accessible Design") { + Talking about iOS applications development support of Accessibility Features is not something extrinsic that comes from adaption but an immanent part of universal design. Building apps using UI frameworks natively suggests accessibility. Default structures used to build interfaces often include sufficient solutions for the elements to be accessible without developers intervention. But even if there is additional work on accessibility being done it something isn't enough for the application to be truly accessible. + + In this tutorial we're going to cover some of the aspects of apps design that are essential to be considered if you want your product to be accessible. + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/ErrorPrevention/ErrorPrevention.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/ErrorPrevention/ErrorPrevention.tutorial index 5ea046e..ff17626 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/ErrorPrevention/ErrorPrevention.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/ErrorPrevention/ErrorPrevention.tutorial @@ -1,29 +1,5 @@ -@Tutorial(time: 20) { +@Article(time: 20) { @Intro(title: "Accessible Mistakes Correction") { FUCK time limits - - @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/Enterprise/Design/VoiceOverDesigner/VoiceOverDesigner.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/VoiceOverDesigner/VoiceOverDesigner.tutorial index 707810f..56ab6b5 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/VoiceOverDesigner/VoiceOverDesigner.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Design/VoiceOverDesigner/VoiceOverDesigner.tutorial @@ -1,17 +1,5 @@ -@Tutorial(time: 15) { +@Article(time: 15) { @Intro(title: "VoiceOver Designer") { } - - @Section(title: "<#text#>") { - @ContentAndMedia { - <#text#> - } - - @Steps { - @Step { - <#Work in progress#> - } - } - } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Maintenance /Maintenance.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Maintenance /Maintenance.tutorial index 42f6f7a..302ff66 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Maintenance /Maintenance.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Maintenance /Maintenance.tutorial @@ -1,4 +1,4 @@ -@Tutorial(time: 15) { +@Article(time: 15) { @Comment { https://www.deque.com/axe/developer-hub/ @@ -6,28 +6,5 @@ @Intro(title: "Accessibility Maintenance") { If supported, any application grows in complexity even if there is no additional functionality added. - - @Image(source: placeholder-image, alt: "") - } - - @Section(title: "No Fucking Idea") { - @ContentAndMedia { - Text! - - @Image(source: chapter-placeholder, alt: "") - } - - @Steps { - @Step { - Text? - - @Image(source: placeholder-image, alt: "") - } - @Step { - Text. - - @Image(source: chapter-placeholder, alt: "") - } - } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.md deleted file mode 100644 index 287025b..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.md +++ /dev/null @@ -1,20 +0,0 @@ -# Processes - -@Metadata { - @PageColor(blue) - @TitleHeading("Accessibility Enterprise") - @PageImage( - purpose: icon, - source: "processes", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Accessibility Production") -} - -## Здесь михаил рубанов и кенты пиздят про цикл жизни приложений в чаптерах diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial new file mode 100644 index 0000000..8e50abc --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Processes.tutorial @@ -0,0 +1,5 @@ +@Article(time: 15) { + @Intro(title: "Integrating Accessibility Into Product Processes") { + + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial index d780763..81e101a 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial @@ -1,35 +1,11 @@ -@Tutorial(time: 15) { +@Article(time: 15) { @Comment { https://w3c.github.io/Mobile-A11y-TF-Note/ https://www.w3.org/TR/wcag2ict-22/ } - @Intro(title: "<#text#>") { + @Intro(title: "Accessibility Compliance") { <#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/Enterprise/Testing/AccessibilityInspector/AccessibilityInspector.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityInspector/AccessibilityInspector.tutorial index 70c7cd3..521edc1 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityInspector/AccessibilityInspector.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityInspector/AccessibilityInspector.tutorial @@ -2,28 +2,5 @@ @Intro(title: "Inspect Accessibility Right In Xcode") { <#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/Enterprise/Testing/AccessibilityQualityAssurance.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityQualityAssurance.md deleted file mode 100644 index 3e38980..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityQualityAssurance.md +++ /dev/null @@ -1,35 +0,0 @@ -# Accessibility Quality Assurance - -Testing is an essential part of production. Just as any other functionality, accessibility of an app has to be tested to make sure that the app is approachable and intuitive. - -@Metadata { - @PageColor(blue) - @TitleHeading("Point Of Many Views") - @PageImage( - purpose: icon, - source: "test", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Testing") -} - -## Testing Team -To test whether your app is accessible it may be helpful to have someone who is a regular user of Accessibility Features. For example, a blind person. But is it strictly required for making an approachable product? -@Image(source: placeholder-image, alt: "") - - -## Accessibility VS UX -Accessibility Testing sometimes exposes issues of user experience nature which have nothing to do with accessibility adaption. See the tutorial below to distinguish between these kinds of bugs and know how to deal with them in accordance. - -## Standards And Certification -Accessibility initiatives often come up with their vision of what makes an application accessible. Let's' go through some of the most common guidelines to see how to make your app legit. - -## Automated Testing -As for today there are more than enough tools to cover certain accessibility checks by automated testing that help testers to organise their work. Such instruments are found helpful to zero the chance of overseeing something and omitting the need to repetitively check the code. - diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityQualityAssurance.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityQualityAssurance.tutorial new file mode 100644 index 0000000..31437ae --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityQualityAssurance.tutorial @@ -0,0 +1,20 @@ +@Article(time: 30) { + @Intro(title: "Accessibility Quality Assurance") { + Testing is an essential part of production. Just as any other functionality, accessibility of an app has to be tested to make sure that the app is approachable and intuitive. + + + ## Testing Team + To test whether your app is accessible it may be helpful to have someone who is a regular user of Accessibility Features. For example, a blind person. But is it strictly required for making an approachable product? + @Image(source: placeholder-image, alt: "") + + + ## Accessibility VS UX + Accessibility Testing sometimes exposes issues of user experience nature which have nothing to do with accessibility adaption. See the tutorial below to distinguish between these kinds of bugs and know how to deal with them in accordance. + + ## Standards And Certification + Accessibility initiatives often come up with their vision of what makes an application accessible. Let's' go through some of the most common guidelines to see how to make your app legit. + + ## Automated Testing + As for today there are more than enough tools to cover certain accessibility checks by automated testing that help testers to organise their work. Such instruments are found helpful to zero the chance of overseeing something and omitting the need to repetitively check the code. + } +} diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/WhatsNext.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/WhatsNext.md deleted file mode 100644 index e911df8..0000000 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/WhatsNext.md +++ /dev/null @@ -1,20 +0,0 @@ -# What's Next? - -@Metadata { - @PageColor(blue) - @TitleHeading("Moving On") - @PageImage( - purpose: icon, - source: "bubble-question", - alt: "") - @PageImage( - purpose: card, - source: "placeholder-image", - alt: "") - @CallToAction( - url: "https://www.apple.com/accessibility/", - purpose: link, - label: "Accessibility Production") -} - -## Буквально пару слов про че дальше diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md index 875c645..74c90b6 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md @@ -7,10 +7,8 @@ purpose: icon, source: "guided-access", alt: "") - @PageImage( - purpose: card, - source: "ga-card - ", + @PageImage(purpose: card, + source: "ga-card", alt: "") @CallToAction( url: "https://www.apple.com/accessibility/", diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md index f9bcf57..4d84b63 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md @@ -82,78 +82,15 @@ Reading the book one may sometimes notice screenshots of iOS applications with * - ### Accessibility In Code -- +- - ### Adapting Strategy -- +- -### Accessible Elements -- -- -- - -### Accessible Scenarios -- -- -- -- - - -### Accessible Interface -- -- -- - -### Greater Accessible Experience -- - -### Accessible Appearance -- -- -- - -### Accessible Description +### Resources - -- -- -- -- - -### Accessible Controls - -- -- -- - -- - -### Accessible Navigation -- -- - -### What's Next? -- -- - -### Design -- -- -- -- - -### Testing -- -- -- -- -- -- - -### Maintenance -- - -### Activism -- -- +- +-