everything is tutorial now

VODGroup · Apr 7, 2024 · 6c6d1c6 · 6c6d1c6
1 parent 4ef3932
commit 6c6d1c6
Show file tree

Hide file tree

Showing 26 changed files with 186 additions and 537 deletions.
diff --git a/...AccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial b/...AccessibilityHandbook/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**.
             <doc:AccessibleDesign>
-
+            @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.
             <doc:AccessibilityQualityAssurance>
 
+            @TutorialReference(tutorial: "doc:AccessibilityQualityAssurance")
             @TutorialReference(tutorial: "doc:AccessibilityChecklists")
             @TutorialReference(tutorial: "doc:AccessibilityInspector")
             @TutorialReference(tutorial: "doc:UnitTesting")
@@ -145,7 +144,6 @@
             <doc:AccessibilityActivism>
 
             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/...occ/Pages/Adaption/Advanced/AccessibleAppearance/ColorsAndShapes/ColorsAndShapes.tutorial b/...occ/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/.../Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md b/.../Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.md
diff --git a/...ages/Adaption/Advanced/AccessibleControls/AdjustableElements/aAdjustableElements.tutorial b/...ages/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 <doc:AdjustableTutorial> 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 <doc:AdjustableTutorial>
+    }
+    }
+}
diff --git a/...lityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md b/...lityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.md
diff --git a/...sibilityHandbook.docc/Pages/Adaption/Advanced/AccessibleControls/aVerticalSwipes.tutorial b/...sibilityHandbook.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 <doc:AdjustableElements> and <doc:AdjustableElements>. 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 <doc:TextInput>
+    }
+}
diff --git a/...on/Basic/Connect/Navigation/Navigation.md → ...ic/Connect/Navigation/Navigation.tutorial b/...on/Basic/Connect/Navigation/Navigation.md → ...ic/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/...Navigation/On-Screen/aControlHierarchy.md → ...tion/On-Screen/aControlHierarchy.tutorial b/...Navigation/On-Screen/aControlHierarchy.md → ...tion/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/...ityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/MobileAccessibility.md b/...ityHandbook/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**](<doc:AdaptionStrategy>). 
+To see the *whole* curriculum visit the [**Table of Contents**](<doc:AdoptionGuide>). 
 
 @Image(source: roadmap, alt: "")
 
 ### Tutorials
-To start right with **practicing** something new, go to [**Based**](<doc:BasicTechniques>) or [**Advanced**](<doc:AdvancedTechniques>) level heading pages according to what you want to learn.
+To start right with **practicing** something new, go to [**Based**](<doc:AccessibleUI>) or [**Advanced**](<doc:AccessibleUX>) level heading pages according to what you want to learn.
 
 @Links(visualStyle: detailedGrid) {
-    - <doc:BasicTechniques>
-    - <doc:AdvancedTechniques>
+    - <doc:AccessibleUI>
+    - <doc:AccessibleUX>
 }
 
 ## Have fun!
diff --git a/...ok/iOSAccessibilityHandbook.docc/Pages/Enterprise/Activism/AccessibilityActivism.tutorial b/...ok/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#>
-            }
-        }
-    }
 }