From 5073a1881e941c2d8818bbdf37ca90b898508e16 Mon Sep 17 00:00:00 2001 From: Mikhail Rubanov Date: Sat, 10 Feb 2024 11:40:50 -0300 Subject: [PATCH] Add structure to tutorials --- .../AdaptionStrategy.tutorial | 80 ++++++++----------- .../HandleErrorsInTextField.tutorial} | 4 +- .../TextInput/HowTextInputWorks.tutorial | 29 +++++++ .../VerticalSwipes/CustomActions.tutorial | 29 +++++++ .../VerticalSwipes/CustomDescription.tutorial | 29 +++++++ .../VerticalSwipes/CustomRotor.tutorial | 29 +++++++ .../{Rotor => VerticalSwipes}/Rotor.tutorial | 2 +- .../VerticalSwipes/aVerticalSwipes.md | 4 +- .../AdaptCells/HideUselessControls.tutorial | 29 +++++++ .../DescribeElements/Traits.tutorial} | 2 +- .../Between-ScreensNavigation.tutorial | 0 .../Essentials/Navigation/Containers.tutorial | 29 +++++++ .../Essentials/Navigation/FocusOrder.tutorial | 29 +++++++ .../OnScreen-Navigation.tutorial | 0 .../VisualProperties/DynamicType.tutorial | 29 +++++++ .../{DynamicType.md => aDynamicType.md} | 0 .../Activism/AccessibilityActivism.tutorial | 0 .../Design/AccessibleDesign.tutorial | 0 .../Design/VoiceOverDesigner.tutorial | 29 +++++++ .../Processes/Processes.md | 0 .../Testing/AccessibilityQA.tutorial | 0 .../Processes/Testing/UITesting.tutorial | 29 +++++++ .../Processes/Testing/UnitTesting.tutorial | 29 +++++++ .../{WhatsNext => Processes}/WhatsNext.md | 0 24 files changed, 359 insertions(+), 52 deletions(-) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/{Essentials/DescribeElements/DescribeElements.tutorial => Advanced/TextInput/HandleErrorsInTextField.tutorial} (87%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HowTextInputWorks.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomActions.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomDescription.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomRotor.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/{Rotor => VerticalSwipes}/Rotor.tutorial (92%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/AdaptCells/HideUselessControls.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/{Advanced/VerticalSwipes/VerticalSwipes.tutorial => Essentials/DescribeElements/Traits.tutorial} (90%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/{Between-ScreensNavigation => Navigation}/Between-ScreensNavigation.tutorial (100%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Containers.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/FocusOrder.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/{On-ScreenNavigation => Navigation}/OnScreen-Navigation.tutorial (100%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/VisualProperties/DynamicType.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/{DynamicType.md => aDynamicType.md} (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/{WhatsNext => Processes}/Processes/Activism/AccessibilityActivism.tutorial (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/{WhatsNext => Processes}/Processes/Design/AccessibleDesign.tutorial (100%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/VoiceOverDesigner.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/{WhatsNext => Processes}/Processes/Processes.md (100%) rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/{WhatsNext => Processes}/Processes/Testing/AccessibilityQA.tutorial (100%) create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UITesting.tutorial create mode 100644 Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UnitTesting.tutorial rename Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/{WhatsNext => Processes}/WhatsNext.md (100%) diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AdaptionStrategy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AdaptionStrategy.tutorial index 9a30e04..356971b 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AdaptionStrategy.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/AdaptionStrategy.tutorial @@ -22,62 +22,37 @@ @Image(source: placeholder-image.png, alt: "") - @Chapter(name: "Alternative Description") { + @Chapter(name: "Provide Description") { @Image(source: chapter-placeholder.png, alt: "") Accompany visuals with a verbose description so people who are unable to see can experience the content too. @TutorialReference(tutorial: "doc:AlternativeDescription") - } - - @Chapter(name: "Colors And Shapes") { - @Image(source: chapter-placeholder.png, alt: "") - - Follow specific guidelines to make your GUI easy to comprehend. - - @TutorialReference(tutorial: "doc:ColorsAndShapes") - } - - @Chapter(name: "Describe Elements") { - @Image(source: chapter-placeholder.png, alt: "") Provide a detailed description to everything so assistive technologies know how to deal with them. - @TutorialReference(tutorial: "doc:DescribeElements") + @TutorialReference(tutorial: "doc:Traits") } - - @Chapter(name: "Adapt Cells") { + @Chapter(name: "Reduce Number of Controls") { @Image(source: chapter-placeholder.png, alt: "") Re-structure complex collections that way so it is easier to navigate between them. @TutorialReference(tutorial: "doc:AdaptCells") + @TutorialReference(tutorial: "doc:HideUselessControls") } @Chapter(name: "On-Screen Navigation") { @Image(source: chapter-placeholder.png, alt: "") - Adapt navigation within a screen for Accessibility Features. - - @TutorialReference(tutorial: "doc:On-ScreenNavigation") - } - - @Chapter(name: "Between-Screens Navigation") { - @Image(source: chapter-placeholder.png, alt: "") - - See how navigation between screens can be implemented. + Adapt navigation within a screen for Accessibility Features and see how navigation between screens can be implemented. + @TutorialReference(tutorial: "doc:OnScreen-Navigation") + @TutorialReference(tutorial: "doc:Containers") + @TutorialReference(tutorial: "doc:FocusOrder") @TutorialReference(tutorial: "doc:Between-ScreensNavigation") } - - @Chapter(name: "Charts") { - @Image(source: chapter-placeholder.png, alt: "") - - Your application displays statistics and you are afraid that charts is an inaccessible case of representation? You will be surprised. - - @TutorialReference(tutorial: "doc:Charts") - } } @Volume(name: "Advanced Adaption Techniques") { @@ -89,37 +64,47 @@ @Chapter(name: "Vertical Swipes") { @Image(source: chapter-placeholder.png, alt: "") - Placeholder text here. I have no fucking idea what is this. + Horizontal swipes are used for navigation, but vertical swipes allows to control inner values of an element. Read about - @TutorialReference(tutorial: "doc:VerticalSwipes") + @TutorialReference(tutorial: "doc:AdjustableElements") + @TutorialReference(tutorial: "doc:CustomActions") + @TutorialReference(tutorial: "doc:CustomDescription") + @TutorialReference(tutorial: "doc:Rotor") + @TutorialReference(tutorial: "doc:CustomRotor") } - - @Chapter(name: "Rotor") { + + @Chapter(name: "Specific Properties") { @Image(source: chapter-placeholder.png, alt: "") - Rotor is the thing you turn with two fingers. + There are several options that is rare needed, but you can be interested in - @TutorialReference(tutorial: "doc:Rotor") + @TutorialReference(tutorial: "doc:SpecificProperties") + @TutorialReference(tutorial: "doc:Charts") } - @Chapter(name: "Adjustable Elements") { + @Chapter(name: "Text Input") { @Image(source: chapter-placeholder.png, alt: "") - Ugh... + There are several options that is rare needed, but you can be interested in - @TutorialReference(tutorial: "doc:AdjustableElements") + @TutorialReference(tutorial: "doc:HowTextInputWorks") + @TutorialReference(tutorial: "doc:HandleErrorsInTextField") } + } + + @Volume(name: "Visual properties") { - @Chapter(name: "Specific Properties") { + @Chapter(name: "Colors And Shapes") { @Image(source: chapter-placeholder.png, alt: "") - No idea really. + Follow specific guidelines to make your GUI easy to comprehend. - @TutorialReference(tutorial: "doc:SpecificProperties") + @TutorialReference(tutorial: "doc:ColorsAndShapes") + @TutorialReference(tutorial: "doc:DynamicType") } } - @Volume(name: "What's Next?") { + @Volume(name: "Processes") { Additional resources expanding on the topic of Accessibility and its integration to design, development and production. @@ -131,6 +116,7 @@ How to design accessible apps. @TutorialReference(tutorial: "doc:AccessibleDesign") + @TutorialReference(tutorial: "doc:VoiceOverDesigner") } @Chapter(name: "Testing") { @@ -139,6 +125,8 @@ How to test accessible apps. @TutorialReference(tutorial: "doc:AccessibilityQA") + @TutorialReference(tutorial: "doc:UnitTesting") + @TutorialReference(tutorial: "doc:UITesting") } @Chapter(name: "Activism") { diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/DescribeElements.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HandleErrorsInTextField.tutorial similarity index 87% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/DescribeElements.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HandleErrorsInTextField.tutorial index 6e1f995..0985c60 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/DescribeElements.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HandleErrorsInTextField.tutorial @@ -1,5 +1,5 @@ -@Tutorial(time: 15) { - @Intro(title: "🔒 Elements Described For Assistive Technology") { +@Tutorial(time: 20) { + @Intro(title: "🔒 Handle Errors in Text Field") { <#text#> @Image(source: <#file#>, alt: "<#accessible description#>") diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HowTextInputWorks.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HowTextInputWorks.tutorial new file mode 100644 index 0000000..1d45805 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/TextInput/HowTextInputWorks.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 How Text Input Works") { + <#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/AdaptionTechniques/Advanced/VerticalSwipes/CustomActions.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomActions.tutorial new file mode 100644 index 0000000..7125df7 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomActions.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 Custom Actions") { + <#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/AdaptionTechniques/Advanced/VerticalSwipes/CustomDescription.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomDescription.tutorial new file mode 100644 index 0000000..b735ced --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomDescription.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 Custom Description") { + <#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/AdaptionTechniques/Advanced/VerticalSwipes/CustomRotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomRotor.tutorial new file mode 100644 index 0000000..87763b1 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/CustomRotor.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 Custom Actions With Rotor") { + <#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/AdaptionTechniques/Advanced/Rotor/Rotor.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/Rotor.tutorial similarity index 92% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/Rotor/Rotor.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/Rotor.tutorial index bbc610a..b59ee9b 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/Rotor/Rotor.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/Rotor.tutorial @@ -1,5 +1,5 @@ @Tutorial(time: 30) { - @Intro(title: "🔒 Custom Actions With Rotor") { + @Intro(title: "🔒 Default Actions With Rotor") { <#text#> @Image(source: <#file#>, alt: "<#accessible description#>") diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/aVerticalSwipes.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/aVerticalSwipes.md index a17aebf..cac05e4 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/aVerticalSwipes.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/aVerticalSwipes.md @@ -1,10 +1,10 @@ -# Vertical Swipes +# 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 and . But vertical swipe is so easy to do and can have a lot of other actions. +Previously we discussed how to add vertical swipe to any element at and . But vertical swipe is so easy to do and can have a lot of other actions. ### Custom action diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/AdaptCells/HideUselessControls.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/AdaptCells/HideUselessControls.tutorial new file mode 100644 index 0000000..31869d2 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/AdaptCells/HideUselessControls.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 10) { + @Intro(title: "🔒 Hide Useless controls") { + <#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/AdaptionTechniques/Advanced/VerticalSwipes/VerticalSwipes.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/Traits.tutorial similarity index 90% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/VerticalSwipes.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/Traits.tutorial index 9e2ba84..20dbe16 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Advanced/VerticalSwipes/VerticalSwipes.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/DescribeElements/Traits.tutorial @@ -1,5 +1,5 @@ @Tutorial(time: 15) { - @Intro(title: "🔒 I Do Not Know Neither Does Mikhail Rubanov") { + @Intro(title: "🔒 Traits") { <#text#> @Image(source: <#file#>, alt: "<#accessible description#>") diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Between-ScreensNavigation/Between-ScreensNavigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Between-ScreensNavigation.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Between-ScreensNavigation/Between-ScreensNavigation.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Between-ScreensNavigation.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Containers.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Containers.tutorial new file mode 100644 index 0000000..9a22c56 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/Containers.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 10) { + @Intro(title: "🔒 Containers") { + <#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/AdaptionTechniques/Essentials/Navigation/FocusOrder.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/FocusOrder.tutorial new file mode 100644 index 0000000..8cae929 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/FocusOrder.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 Focus Order") { + <#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/AdaptionTechniques/Essentials/On-ScreenNavigation/OnScreen-Navigation.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/OnScreen-Navigation.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/On-ScreenNavigation/OnScreen-Navigation.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/Essentials/Navigation/OnScreen-Navigation.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/VisualProperties/DynamicType.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/VisualProperties/DynamicType.tutorial new file mode 100644 index 0000000..43c1e3d --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/AdaptionTechniques/VisualProperties/DynamicType.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 30) { + @Intro(title: "🔒 Dynamic Type") { + <#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/DynamicType/DynamicType.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/aDynamicType.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/DynamicType.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/AccessibilityFeatures/DynamicType/aDynamicType.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Activism/AccessibilityActivism.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Activism/AccessibilityActivism.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Activism/AccessibilityActivism.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Activism/AccessibilityActivism.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Design/AccessibleDesign.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/AccessibleDesign.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Design/AccessibleDesign.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/AccessibleDesign.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/VoiceOverDesigner.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/VoiceOverDesigner.tutorial new file mode 100644 index 0000000..97d31f8 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Design/VoiceOverDesigner.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: <#number#>) { + @Intro(title: "🔒 VoiceOver Designer") { + <#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/WhatsNext/Processes/Processes.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Processes.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Processes.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Processes.md diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Testing/AccessibilityQA.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/AccessibilityQA.tutorial similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/Processes/Testing/AccessibilityQA.tutorial rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/AccessibilityQA.tutorial diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UITesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UITesting.tutorial new file mode 100644 index 0000000..d6b83c0 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UITesting.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: <#number#>) { + @Intro(title: "🔒 UI Testing") { + <#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/Processes/Processes/Testing/UnitTesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UnitTesting.tutorial new file mode 100644 index 0000000..1fe6c96 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/Processes/Testing/UnitTesting.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "🔒 Unit Testing") { + <#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/WhatsNext/WhatsNext.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/WhatsNext.md similarity index 100% rename from Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/WhatsNext/WhatsNext.md rename to Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Processes/WhatsNext.md