docc mastery

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Advanced/AdaptContent/SensorySystem.md

@@ -2,10 +2,6 @@
 
 A quick dip back into primordial soup to understand why everyone experiences the same world differently.
 
-@Comment {
-    tactile UI (touch), visual UI (sight), auditory UI (sound), olfactory UI (smell), equilibria UI (balance), and gustatory UI (taste)
-}
-
 @Metadata {
     @PageColor(blue)
     @TitleHeading("Mental Modelling")
@@ -31,27 +27,66 @@ Operating a phone is essentially an exchange of data: the device provides inform
 Being a living creature means **continuous communication with *reality***. But what exactly *is* reality? 
 
 ## Reality is a set of objects with stated properties
-@Image(source: milky-way, alt: "")
+
+@Image(source: milky-way, alt: "") {
+    *"Reality"* often refers to the **observable universe*
+}
 
 **Reality** as a conceptional model consisting of facts that define everything embedded in the universe. A *worldview*, which is **knowledge of the world**, is built of **perception** of these facts.
 
 
 ## One world - many worldviews
-@Image(source: earth, alt: "")
+
+@Image(source: earth, alt: "") {
+    All life lives on the same Earth
+}
+
 
 The complexity of reality made carbon-based lifeforms diverse that much so it's hard to believe that all inhabitants of Earth share the same nature. Bacteria, insects, fish, cats, humans, corals, pine trees and mushrooms - all living creatures are made of the same elements by the same rules and live in the same world.
 
-@Image(source: fish, alt: "")
+@Image(source: fish, alt: "") {
+    Lifeforms diversity is unmeasurable 
+}
 
 Nevertheless those living creatures who are sentient, i.e. able to sense, perceive the world differently. Each species have their own knowledge of the world, their own *worldview*, defined by the set of perceptional abilities available for them. A model of **cognised environment** is called [**umwelt**](https://en.wikipedia.org/wiki/Umwelt), and an umwelt is consistent of [**qualias**](https://en.wikipedia.org/wiki/Qualia) - instances of **subjective experience**. 
 
 ## Experience is composite
 Subjectiveness of experience comes from the types of information species are able to recognise. A set of such abilities available for a specie is called a perceptional system.
-@Image(source: eyes, alt: "")
+
+@Image(source: eyes, alt: "") {
+    Evolution made different eyes see what is needed
+}
 
 
 ## Sensory systems of different species
-@Image(source: senses, alt: "")
+@Row {
+   @Column {
+      @Image(source: eye, alt: "") {
+          Sight
+      }
+   }
+   @Column {
+      @Image(source: touch, alt: "") {
+          Touch
+      }
+   }
+   @Column {
+      @Image(source: mouth, alt: "") {
+          Taste
+      }
+   }
+   @Column {
+      @Image(source: ear, alt: "") {
+          Sound
+      }
+   }
+   @Column {
+      @Image(source: nose, alt: "") {
+          Smell
+      }
+   }
+}
+
 Creatures are differentiated by their evolutionary development: for example, humans and cats are of one biological class - mammals. 
 
 All mammals are capable of developing the same kinds of cells for particular receptional organs. 

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/Basic/Connect/Navigation/On-Screen/aControlHierarchy.md

@@ -4,8 +4,8 @@
     @PageColor(blue)
     @TitleHeading("First Things First")
     @PageImage(
-               purpose: flowchart, 
-               source: "-", 
+               purpose: icon, 
+               source: "flowchart", 
                alt: "")
     @PageImage(
                purpose: card, 

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AAC/AAC.md

@@ -1,5 +1,7 @@
 # Alternative Communication 
 
+Nothing here yet!
+
 @Comment {
     https://www.apple.com/newsroom/2023/05/assistiveware-ushers-in-next-generation-of-aac-technology/
 }

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/AssistiveAccess/AssistiveAccess.md

@@ -1,5 +1,7 @@
 # Assistive Access
 
+An accessible mode of simplified iOS
+
 @Metadata {
     @PageColor(blue)
     @TitleHeading("Keep It Simple")
@@ -9,15 +11,14 @@
                alt: "")
     @PageImage(
                purpose: card, 
-               source: "card-aa", 
+               source: "aa-card", 
                alt: "")
     @CallToAction(
                 url: "https://www.apple.com/accessibility/",
                 purpose: link, 
                 label: "General Knowledge")
 }
 
-An accessible mode of simplified iOS
 
 ## Meet Assistive Access
 **Assistive Access** is a new [**Accessibility Feature**](<doc:AccessibilityFeatures>) presented at **WWDC23**. 
@@ -27,7 +28,7 @@ An accessible mode of simplified iOS
 
 The feature is purposed to provide a drastically **simplified UI of the whole system** with help of [**Dynamic Type**](<doc:DynamicType>) and fundamentally different layouts of **adapted apps** to lighten *cognitive load* for those in need. 
 
-@Image(source: assistive-access-1, alt: "")
+@Image(source: aa-1, alt: "")
 
 ------------------------------------------------------
 
@@ -37,7 +38,7 @@ The feature is dedicated to enable anyone use their device **independently** reg
 
 The technology's task is to **reduce applications functionality** to the point when the possibility that everyone can find app's interface understandable is *maximal*. 
 
-@Image(source: assistive-access-2, alt: "")
+@Image(source: aa-2, alt: "")
 
 
 So people who have **cognitive** or **learning impairments** could easily use iPhones *on their own*. 
@@ -49,7 +50,7 @@ So people who have **cognitive** or **learning impairments** could easily use iP
 2. Choose **Accessibility** category
 3. Find **Assistive Access** at the bottom
 4. Follow feature's **instructions**
-@Image(source: turn-on-aa, alt: "")
+@Image(source: aa-setup, alt: "")
 
 
 ## Principles of Assistive Access

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/FullKeyboardAccess/FullKeyboardAccess.md

@@ -19,8 +19,6 @@ Control an iPhone using an external physical keyboard.
                   label: "General Knowledge")
 }
 
-## Overview
-
 Full Keyboard Access is a feature that enables using an external physical keyboard to *fully* control an iPhone or (more commonly) an iPad. 
 
 @Image(source: iphone-with-keyboard, alt: "")

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceControl/VoiceControl.md

@@ -1,5 +1,30 @@
 # Voice Control
 
+@Metadata {
+    @PageColor(blue)
+    @TitleHeading("Command By Voice")
+    @PageImage(
+               purpose: icon, 
+               source: "voice-control", 
+               alt: "")
+    @PageImage(
+               purpose: card, 
+               source: "voice-control-picker-example", 
+               alt: "")
+    @CallToAction(
+                url: "https://www.apple.com/accessibility/",
+                purpose: link, 
+                label: "General Knowledge")
+}
+
+@Row {
+   @Column {
+      @Image(source: "placeholder-image", alt: "") {
+         Placeholder
+      }
+   }
+}
+
 Adds additional commands over graphical UI to control a phone by voice commands. A user of Voice Control can see, but can't touch their phone, as a result he can pronounce commands lite "select Pepperoni", "tap purchase" or "close screen". iPhone recognises speech, convert it to text and links command to elements' description.
 
 Voice Control is a feature that allows to operate devices by the use of voice. 
@@ -22,22 +47,7 @@ It may be perceived as a complex case of Switch Control with a much wider range
     https://www.apple.com/macos/big-sur/docs/Voice_Control_Tech_Brief_Sept_2019.pdf
 }
 
-@Metadata {
-    @PageColor(blue)
-    @TitleHeading("Command By Voice")
-    @PageImage(
-               purpose: icon, 
-               source: "voice-control", 
-               alt: "")
-    @PageImage(
-               purpose: card, 
-               source: "voice-control-picker-example", 
-               alt: "")
-    @CallToAction(
-                url: "https://www.apple.com/accessibility/",
-                purpose: link, 
-                label: "General Knowledge")
-}
+
 
 
 

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/VoiceOver/VoiceOver.md

@@ -1,5 +1,7 @@
 # VoiceOver
 
+VoiceOver is a **screen reader** built into iOS.
+
 @Comment {
     https://www.apple.com/voiceover/info/guide/_1121.html
 }
@@ -21,14 +23,23 @@
                 label: "General Knowledge")
 }
 
-VoiceOver is a **screen reader** built into iOS.
 
 ## Screen-Reading Technology
 A screen reader is a form of [**assistive technology**](<doc:AccessibilityFeatures>) — a program that conveys *visual* content into *non-visual* output. It allows people who cannot visually perceive information from the screen to be able to receive it in audial or tactile forms. 
 
 ## Text-to-speech
-@Image(source: non-visual-output, alt: "")
-
+@Row {
+   @Column {
+      @Image(source: "speech-output", alt: "") {
+          **Audial form** comes in **synthesised speech** or **sound icons**
+      }
+   }
+   @Column {
+      @Image(source: "braille-output", alt: "") {
+          **Tactile form** comes in **braille script** or **haptic feedback**
+      }
+   }
+}
 Screen readers are essential for users who...
 1) have *visual disablements*, such as **blindness** or **poor eyesight**;
 2) experience **dyslexia** or other *cognitive impairments*;

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/UIFrameworks.md

@@ -18,5 +18,50 @@
 }
 
 ## UI Frameworks Differences
+First | Second | Third |
+----- | ------ | ----- |
+One           || Two   |
+Three | Four          ||
+Five                 |||
 
+Leading | Center | Trailing |
+------: | :----: | :------- |
+One             || Two      |
+Three   | Four             ||
+Five                      |||
+
+First | Second | Third | Fourth 
+----- | ------ | ----- | ------
+One   | Two    | Three | Four
+^     | Five   | ^     | Six
+Seven | ^      | ^     | Eight
+
+First | Second | Third 
+----- | ------ | ----- 
+One           || Two   
+^             || Three 
+
+| Sloth speed  | Description                          |                         
+| ------------ | ------------------------------------ |
+| `slow`       | Moves slightly faster than a snail   | 
+| `medium`     | Moves at an average speed            |  
+| `fast`       | Moves faster than a hare             |
+| `supersonic` | Moves faster than the speed of sound |
+
+@TabNavigator {
+   @Tab("First") {
+      Jepa.
+      @Image(source: placeholder-image, alt: "")
+   }
+
+
+   @Tab("Second") {
+      Jepa?
+   }
+
+
+   @Tab("Third") {
+      Jepa.
+   }
+}
 ## Здесь нужно буквально пару параграфов про дихотомию фреймворков и как одни и те же аксесибилити решения работают в обоях (одинаково)

Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md

@@ -2,6 +2,13 @@
 
 Make your iOS application accessible for everyone
 
+@Options(scope: global) {
+    @AutomaticSeeAlso(disabled)
+    @AutomaticTitleHeading(disabled)
+    @AutomaticArticleSubheading(disabled)
+    @TopicsVisualStyle(hidden)
+}
+
 @Metadata {
     @DisplayName("iOS Accessibility Handbook")
     @TitleHeading("Educational Resource")
@@ -55,7 +62,9 @@ The resources are provided by **Mikhail Rubanov**, Head of Mobile Development at
 Reading the book one may sometimes notice screenshots of iOS applications with *mark-ups* related to accessibility design over them. This is [**VoiceOver Designer**](https://rubanov.dev/voice-over-designer), an [open-source](https://github.com/VODGroup/VoiceOverDesigner) macOS application that allows to design *accessibility scenarios* over a screenshot of an app. 
 @Image(source: "vod-sample", alt: "-")
 
-
+@Small {
+    *iOS Accessibility Handbook, 2024*
+}
 
 ## Topics
 ### General Knowledge