diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial index 39b0adb..df9df80 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/AdoptionGuide.tutorial @@ -1,4 +1,4 @@ -@Tutorials(name: "AdoptionGuide") { +@Tutorials(name: "iOS Accessibility") { @Intro(title: "iOS Accessibility Guide") { This collection of guides may be perceived as a complete course on accessibility of iOS apps: from the very basics to professional system design solution. @@ -27,19 +27,20 @@ @TutorialReference(tutorial: "doc:AccessibilityAttributes") } - @Chapter(name: "Ensure that navigation is possible") { - @Image(source: chapter-1-2.png, alt: "") + @Chapter(name: "Secure user scenarios") { + @Image(source: chapter-1-3.png, alt: "") - Secondly, to *reconnect* the elements into a integral interface certain **alternative controlling options** have to be enabled. + Secondly, to make sure that the users of assistive technology are able to complete the tasks they are *supposed* to achieve we should **review the layout** of the accessible interface. + @TutorialReference(tutorial: "doc:AdaptCells") } - @Chapter(name: "Secure user scenarios") { - @Image(source: chapter-1-3.png, alt: "") + @Chapter(name: "Ensure that navigation is possible") { + @Image(source: chapter-1-2.png, alt: "") - Lastly, to make sure that the users of assistive technology are able to complete the tasks they are *supposed* to achieve we should **review the layout** of the accessible interface. + Lastly, to *reconnect* the elements into a integral interface certain **alternative controlling options** have to be enabled. + @TutorialReference(tutorial: "doc:Navigation") - @TutorialReference(tutorial: "doc:AdaptCells") } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/ControlHierarchy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/ControlHierarchy.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/ControlHierarchy.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/FocusManagement.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/FocusManagement.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/FocusManagement.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/OnScreen-Navigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/OnScreen-Navigation.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/OnScreen-Navigation.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/aControlHierarchy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/aControlHierarchy.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/On-Screen/aControlHierarchy.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Advanced/AccessibleNavigation/On-Screen/aControlHierarchy.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/Navigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/Navigation.tutorial index 10337c8..15d4b9d 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/Navigation.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Connect/Navigation/Navigation.tutorial @@ -21,7 +21,7 @@ Talking about our mission in this tutorial we are going to learn how to ensure that every elements on a screen is reachable with usage of assistive technology, so let's start to figure out what may be an issue. } - @Section(title: "Horizontal swipes and accessible scroll") { + @Section(title: "Horizontal swipes") { @ContentAndMedia { We already know how [**Accessibility Features**]() build their Accessibility Tree. Our goal is to make sure that the elements are presented in the right order and are accessible for consequential selection. } @@ -46,17 +46,91 @@ @Step { Our task is to ensure that elements iterated in the order that repeats the order of visual perception of the interface to convey the same cognitive model. } + } + } + + @Section(title: "Cognitive models") { + @ContentAndMedia { + } + @Steps { @Step { Let's take a look at our screen and flatten it to a textual description of elements in the order they are placed on the screen. But is it how we present it? } @Step { - Nope, it's not an ideal representation of the idea. + Nope, it's not an ideal representation of the interface. First of all, it has 17 "accessible" elements. It's not that many, but a tailored layout will always have less. + + > Note: And 7 inaccessible ones. Images are hidden by default. + } + + @Step { + Next we have a few product card available on the screen: smaller ones under "You'll enjoy it" header and normal ones of endless quantity under categories buttons. + } + + @Step { + The previous tutorial was fully dedicated to complex cells, so we already know how to make this experience more comfortable: without buttons of unclear context and meaningful semantics. + } + + @Step { + Now let's poke at something unknown yet. } } } - + + @Section(title: "Vertical Swipes") { + @ContentAndMedia { + + } + @Steps { + @Step { + + } + } + } + + @Section(title: "Notifications") { + @ContentAndMedia { + + } + @Steps { + @Step { + + } + } + } + + @Section(title: "Modal views") { + @ContentAndMedia { + + } + @Steps { + @Step { + + } + } + } + + @Section(title: "Special gestures") { + @ContentAndMedia { + + } + @Steps { + @Step { + + } + } + } + + @Section(title: "Wrap-up") { + @ContentAndMedia { + + } + } + + @Assessment { + + } } } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Describe/AccessibilityAttributes/AccessibilityAttributes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Describe/AccessibilityAttributes/AccessibilityAttributes.tutorial index 7d2a32f..f8462f7 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Describe/AccessibilityAttributes/AccessibilityAttributes.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Integration/Basic/Describe/AccessibilityAttributes/AccessibilityAttributes.tutorial @@ -257,7 +257,7 @@ } } - @Section(title: "THAT'S ALL FOR NOW") { + @Section(title: "Wrap-up") { @ContentAndMedia { Congratulations! Now you know everything needed to fully **describe elements for *both* users and assistive technology**. 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 93d0394..a6d6be7 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 @@ -214,7 +214,7 @@ } } - @Section(title: GREAT JOB!) { + @Section(title: "Wrap-up") { @ContentAndMedia { This is only the second tutorial of the book and we've already learnt the most of basics in accessibility of iOS application. Please, don't get scared of the further studying: the next tutorial will wrap-up the foundation, and afterwards everything contained in the second volume is about everything we mentioned here but in much greater detail.