From a6b9d5f303f983272d645255dcc64f67e4621afe Mon Sep 17 00:00:00 2001
From: Mikhail Rubanov <akaDuality@yandex.ru>
Date: Sun, 17 Dec 2023 20:13:16 -0300
Subject: [PATCH] Add documents

---
 .../SwitchControl.md                          |  0
 .../VoiceControl.md                           |  0
 .../VoiceOver.md                              |  0
 .../{Process => 1.Basic}/ControlHierarchy.md  |  0
 .../{Process => 1.Basic}/DescribeElements.md  |  0
 .../Articles/1.Basic/Navigation.md            | 31 +++++++++++++++++++
 .../SpecificProperties.md                     |  0
 .../{Process => 1.Basic}/VisualProperties.md  |  0
 .../{ => 2.Advanced}/AdjustableElements.md    |  0
 .../Articles/2.Advanced/VerticalSwipe.md      | 31 +++++++++++++++++++
 .../Articles/Process/Navigation.md            | 11 -------
 .../Documentation.docc/Getting Started.md     | 14 +++++++++
 .../{ => 1,Basic}/AdoptingCell.tutorial       |  0
 .../AdjustableTutorial.tutorial               |  0
 14 files changed, 76 insertions(+), 11 deletions(-)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{AssistiveTechnologies => 0.AssistiveTechnologies}/SwitchControl.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{AssistiveTechnologies => 0.AssistiveTechnologies}/VoiceControl.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{AssistiveTechnologies => 0.AssistiveTechnologies}/VoiceOver.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{Process => 1.Basic}/ControlHierarchy.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{Process => 1.Basic}/DescribeElements.md (100%)
 create mode 100644 Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/Navigation.md
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{Process => 1.Basic}/SpecificProperties.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{Process => 1.Basic}/VisualProperties.md (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Articles/{ => 2.Advanced}/AdjustableElements.md (100%)
 create mode 100644 Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/VerticalSwipe.md
 delete mode 100644 Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/Navigation.md
 rename Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/{ => 1,Basic}/AdoptingCell.tutorial (100%)
 rename Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/{ => 2.Advanced}/AdjustableTutorial.tutorial (100%)

diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/SwitchControl.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/SwitchControl.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/SwitchControl.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/SwitchControl.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/VoiceControl.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/VoiceControl.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/VoiceControl.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/VoiceControl.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/VoiceOver.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/VoiceOver.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/AssistiveTechnologies/VoiceOver.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/0.AssistiveTechnologies/VoiceOver.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/ControlHierarchy.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/ControlHierarchy.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/ControlHierarchy.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/ControlHierarchy.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/DescribeElements.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/DescribeElements.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/DescribeElements.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/DescribeElements.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/Navigation.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/Navigation.md
new file mode 100644
index 0000000..5b5d894
--- /dev/null
+++ b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/Navigation.md
@@ -0,0 +1,31 @@
+# Navigation
+
+To simplify navigation developer had to achieve several goals: reduce number of elements, fix focus order and support several additional actions
+
+## Overview
+
+<!--@START_MENU_TOKEN@-->Text<!--@END_MENU_TOKEN@-->
+
+### Reduce number of elements
+
+@Comment {
+    // TODO: It should be part of <doc:ControlHierarchy>
+}
+
+### Focus order
+
+### Escape gesture
+
+### Magic tap
+
+### Switch control and grouping
+
+#### VoiceOver supports grouping
+
+@Comment {
+    // TODO: Check VoiceOver grouping
+}
+
+## Topics
+- <doc:ControlHierarchy>
+- <doc:AdoptingCell>
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/SpecificProperties.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/SpecificProperties.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/SpecificProperties.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/SpecificProperties.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/VisualProperties.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/VisualProperties.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/VisualProperties.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/1.Basic/VisualProperties.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/AdjustableElements.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/AdjustableElements.md
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Articles/AdjustableElements.md
rename to Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/AdjustableElements.md
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/VerticalSwipe.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/VerticalSwipe.md
new file mode 100644
index 0000000..6b9252d
--- /dev/null
+++ b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/2.Advanced/VerticalSwipe.md
@@ -0,0 +1,31 @@
+# Vertical Swipe
+
+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:AdjustableTutorial>. 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/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/Navigation.md b/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/Navigation.md
deleted file mode 100644
index 41b7097..0000000
--- a/Sources/AccessibilityDocumentation/Documentation.docc/Articles/Process/Navigation.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Navigation
-
-<!--@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/AccessibilityDocumentation/Documentation.docc/Getting Started.md b/Sources/AccessibilityDocumentation/Documentation.docc/Getting Started.md
index 0b58b2e..4f0b425 100644
--- a/Sources/AccessibilityDocumentation/Documentation.docc/Getting Started.md	
+++ b/Sources/AccessibilityDocumentation/Documentation.docc/Getting Started.md	
@@ -32,8 +32,22 @@ Step by step practice course.
 
 ## Topics
 
+### Assistive Technologies
+- <doc:VoiceOver>
+- <doc:VoiceControl>
+- <doc:SwitchControl>
+
+### Basic
 - <doc:DescribeElements>
 - <doc:ControlHierarchy>
 - <doc:VisualProperties>
 - <doc:Navigation>
 - <doc:SpecificProperties>
+
+### Advanced
+- <doc:AdjustableElements>
+- <doc:VerticalSwipe>
+
+Tutorial: 
+- <doc:AdjustableTutorial>
+
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/AdoptingCell.tutorial b/Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/1,Basic/AdoptingCell.tutorial
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/AdoptingCell.tutorial
rename to Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/1,Basic/AdoptingCell.tutorial
diff --git a/Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/AdjustableTutorial.tutorial b/Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/2.Advanced/AdjustableTutorial.tutorial
similarity index 100%
rename from Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/AdjustableTutorial.tutorial
rename to Sources/AccessibilityDocumentation/Documentation.docc/Tutorials/2.Advanced/AdjustableTutorial.tutorial