From a13f04346b213e16ac126b643f76de782ed3fe40 Mon Sep 17 00:00:00 2001
From: "C." <crescenth@keemail.me>
Date: Wed, 21 Feb 2024 17:19:11 +0300
Subject: [PATCH] some notes

---
 .../AccessibilityAdaption.md                  | 20 ++++++++++
 .../VisualProperties/ColorsAndShapes.tutorial |  3 ++
 .../VisualProperties/DynamicType.tutorial     |  6 ++-
 .../AccessibleReading/AccessibleReading.md    | 11 +++++
 .../AdditionalDescription.tutorial            | 28 +++++++++++++
 .../AlternativeDescription.tutorial           | 29 ++++++++++++++
 .../GuidedAccess/GuidedAccess.tutorial        | 29 ++++++++++++++
 .../{GuidedAccess.md => aGuidedAccess.md}     |  0
 .../Design/AccessibleDesign.tutorial          | 40 ++++++++++++++++++-
 .../Pages/Processes/Design/ErrorPrevention.md | 11 +++++
 .../Testing/AccessibilityInspector.md         | 11 +++++
 .../Processes/Testing/UITesting.tutorial      |  2 +-
 .../Processes/Testing/UnitTesting.tutorial    |  2 +-
 13 files changed, 188 insertions(+), 4 deletions(-)
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AccessibleReading/AccessibleReading.md
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AdditionalDescription/AdditionalDescription.tutorial
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AlternativeDescription/AlternativeDescription.tutorial
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial
 rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/{GuidedAccess.md => aGuidedAccess.md} (100%)
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/ErrorPrevention.md
 create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/AccessibilityInspector.md

diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AccessibilityAdaption.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AccessibilityAdaption.md
index bff2e43..08d4ee0 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AccessibilityAdaption.md
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AccessibilityAdaption.md
@@ -19,6 +19,26 @@
 
 Nothing here yet, but one day will be a verbose guide on how to develop accessible application with overview of actions needed to be done.
 
+Thanks to Apple's decision to protect diversity and invest to accessibility it is not a unworkable ordeal to create accessible software for their systems. 
+
+Talking about iOS the system supports an impressive range of assistive technology and provides highly comprehensible resources for their API. 
+
+Both of two possible user interface frameworks, UIKit and SwiftUI equally provide accessible underlayment for applications built with their use. 
+
+Constructing an interface out of default elements majorly covers the functionality of Accessible Features. 
+
+Having custom elements designed specifically for your interface requires a little bit more work done on supporting Accessibility Feature but isn't exhausting too. 
+
+## Why developer may want to create accessible experience
+
+## Accessibility as a core value of Apple
+
+## iOS Accessibility Toolkit
+
+## Adaption Strategy
+
+## More on Accessibility
+
 ## Небольшой зачин для интро (про что эта статья)
 
 ## Зачем нужно делать доступные приложения - табличка с видами дизабилитис с фокусом на матерей в слингах в кофейнях и автомобилистах. Про статистику использования аксесиблити сетинг, про расширение аудитории, пару слов про ДОБРОДЕТЕЛЬ 
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/ColorsAndShapes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/ColorsAndShapes.tutorial
index f44d03b..bfc0e2b 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/ColorsAndShapes.tutorial
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/ColorsAndShapes.tutorial
@@ -7,6 +7,9 @@
 
     
     
+    > Note: Accessibility Inspector has a built-in instrument
+    
+    
     @Section(title: "<#text#>") {
         @ContentAndMedia {
             <#text#>
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/DynamicType.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/DynamicType.tutorial
index 72fd1c3..feefff1 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/DynamicType.tutorial
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VisualProperties/DynamicType.tutorial
@@ -1,9 +1,13 @@
 @Tutorial(time: 30) {
     @Intro(title: "🔒 Dynamic Type") {
+        
+        7 РАЗМЕРОВ ШРИФТА ДЛЯ ПЕРЕБИРАНИЯ ХАРЧАМИ, 5 ДЛЯ ТЕХ КОМУ РЕАЛЬНО НАДО
+        
+        https://developer.apple.com/wwdc19/261
+        
         @Image(source: vision-loss, alt: "")
     }
     
-
     
     @Section(title: "<#text#>") {
         @ContentAndMedia {
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AccessibleReading/AccessibleReading.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AccessibleReading/AccessibleReading.md
new file mode 100644
index 0000000..72d4db1
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AccessibleReading/AccessibleReading.md
@@ -0,0 +1,11 @@
+# AccessibleReading
+
+<!--@START_MENU_TOKEN@-->Summary<!--@END_MENU_TOKEN@-->
+
+## Overview
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
+
+### Section header
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AdditionalDescription/AdditionalDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AdditionalDescription/AdditionalDescription.tutorial
new file mode 100644
index 0000000..d949b19
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AdditionalDescription/AdditionalDescription.tutorial
@@ -0,0 +1,28 @@
+@Tutorial(time: <#number#>) {
+    @Intro(title: "<#text#>") {
+        AvSpeechSynthesizer talk here.
+        @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/AdaptionTechniques/Essentials/Describe/AlternativeDescription/AlternativeDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AlternativeDescription/AlternativeDescription.tutorial
new file mode 100644
index 0000000..b7a5bd9
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Describe/AlternativeDescription/AlternativeDescription.tutorial
@@ -0,0 +1,29 @@
+@Tutorial(time: 15) {
+    @Intro(title: "How To Describe Visual Content") {
+        Some guidelines here.
+        
+        @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/GuidedAccess/GuidedAccess.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial
new file mode 100644
index 0000000..a6db784
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.tutorial
@@ -0,0 +1,29 @@
+@Tutorial(time: <#number#>) {
+    @Intro(title: "<#text#>") {
+        <#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/GuidedAccess/GuidedAccess.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md
similarity index 100%
rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/GuidedAccess.md
rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/GuidedAccess/aGuidedAccess.md
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/AccessibleDesign.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/AccessibleDesign.tutorial
index 7dfe351..d786a00 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/AccessibleDesign.tutorial
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/AccessibleDesign.tutorial
@@ -1,9 +1,47 @@
 @Tutorial(time: 20) {
     @Intro(title: "🔒 Making Products Accessible From The Beginning") {
+        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.
     }
     
-    @Section(title: "<#text#>") {
+    @Section(title: "Make Accessible For Everyone") {
+        @ContentAndMedia {
+            <#text#>
+        }
+        
+        @Steps {
+            @Step {
+                <#Work in progress#>
+            }
+        }
+    }
+    
+    @Section(title: "Be Curious") {
+        @ContentAndMedia {
+            <#text#>
+        }
+        
+        @Steps {
+            @Step {
+                <#Work in progress#>
+            }
+        }
+    }
+    
+    @Section(title: "Have A Diverse Team") {
+        @ContentAndMedia {
+            <#text#>
+        }
+        
+        @Steps {
+            @Step {
+                <#Work in progress#>
+            }
+        }
+    }
+    
+    @Section(title: "Gather Feedback") {
         @ContentAndMedia {
             <#text#>
         }
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/ErrorPrevention.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/ErrorPrevention.md
new file mode 100644
index 0000000..0063f9b
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Design/ErrorPrevention.md
@@ -0,0 +1,11 @@
+# ErrorPrevention
+
+Fuck time limits
+
+## Overview
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
+
+### Section header
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/AccessibilityInspector.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/AccessibilityInspector.md
new file mode 100644
index 0000000..7b9679a
--- /dev/null
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/AccessibilityInspector.md
@@ -0,0 +1,11 @@
+# AccessibilityInspector
+
+Lovely helper!
+
+## Overview
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
+
+### Section header
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UITesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UITesting.tutorial
index e5ab915..fea2506 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UITesting.tutorial
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UITesting.tutorial
@@ -1,6 +1,6 @@
 @Tutorial(time: 30) {
     @Intro(title: "🔒 UI Testing") {
-        
+        Михаил Рубанов знает.
     }
     
     @Section(title: "<#text#>") {
diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UnitTesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UnitTesting.tutorial
index 2b71643..f144a77 100644
--- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UnitTesting.tutorial
+++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Testing/UnitTesting.tutorial
@@ -1,6 +1,6 @@
 @Tutorial(time: 20) {
     @Intro(title: "🔒 Unit Testing") {
-        
+        Михаил Рубанов знает.
     }
     
     @Section(title: "<#text#>") {