diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial index 34eaac8..077cb1c 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdaptionStrategy.tutorial @@ -121,8 +121,10 @@ How to test accessible apps. + @TutorialReference(tutorial: "doc:AccessibilityChecklists") @TutorialReference(tutorial: "doc:AccessibilityInspector") @TutorialReference(tutorial: "doc:UnitTesting") + @TutorialReference(tutorial: "doc:SnapshotTesting") @TutorialReference(tutorial: "doc:UITesting") } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial new file mode 100644 index 0000000..d780763 --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/AccessibilityChecklists/AccessibilityChecklists.tutorial @@ -0,0 +1,35 @@ +@Tutorial(time: 15) { + + @Comment { + https://w3c.github.io/Mobile-A11y-TF-Note/ + https://www.w3.org/TR/wcag2ict-22/ + } + + @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/Enterprise/Testing/UITesting/UITesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UITesting/UITesting.tutorial index 275be8e..05876e9 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UITesting/UITesting.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UITesting/UITesting.tutorial @@ -4,7 +4,7 @@ https://www.deque.com/axe/devtools/mobile-accessibility/ } - @Intro(title: "UI Testing") { + @Intro(title: "UI Accessibility Testing") { Михаил Рубанов знает. } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial new file mode 100644 index 0000000..79bef0c --- /dev/null +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/SnapshotTesting/SnapshotTesting.tutorial @@ -0,0 +1,29 @@ +@Tutorial(time: 20) { + @Intro(title: "Snapshot Accessibility 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/Enterprise/Testing/UnitTesting/UnitTesting.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/UnitTesting.tutorial index c7d7d9e..4fd0180 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/UnitTesting.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Enterprise/Testing/UnitTesting/UnitTesting.tutorial @@ -1,5 +1,5 @@ @Tutorial(time: 20) { - @Intro(title: "Unit Testing") { + @Intro(title: "Unit Accessibility Testing") { Михаил Рубанов знает. } diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Glossary.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Glossary.md index 4406c1a..7071df9 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Glossary.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Glossary.md @@ -29,6 +29,8 @@ container layout control element +focus +label picker slider segmented control diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md index e36e021..d8f8209 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md @@ -29,20 +29,20 @@ There are many reasons why one would want to *include* more people — from stra @Image(source: fifteen-percent, alt: "") ## Digital Accessibility -Digital accessibility, often referred to as a11y, includes a wide range of solutions that are aimed to enhance approachability of digital technology. It may done by using assistive technology, which is specialised software or hardware, or a combination of both. +Digital accessibility, often referred to as **a11y**, includes a wide range of solutions that are aimed to enhance approachability of digital technology. It can be done by using **assistive technology**, which is specialised *software* or *hardware*, or a *combination* of both. @Image(source: a11y, alt: "") ## iOS Accessibility -In this book we are going to discuss how to make iOS applications accessible. Due to the current state of technological advancement it may be narrowed to adapting your programs to the use of assistive technology, which involves nothing more than following specific design guidelines that support the usage of Accessibility Features and promote inclusivity. +In this book we are going to discuss **how to make iOS applications accessible**. Due to the current state of technological advancement the task may be narrowed to *adapting* your programs to the use of **assistive technology**, which involves nothing more than following [**specific design guidelines**]() that support the usage of [**Accessibility Features**]() and promote **inclusivity**. @Image(source: ios-a11y, alt: "") ### History of iOS Accessibility -[**"A Timeline of iOS Accessibility: It Started with 36 Seconds"**](https://www.macstories.net/stories/a-timeline-of-ios-accessibility-it-started-with-36-seconds/) is a marvellous research done by Shelly Brisbin that covers the path that Apple has been following to make their mobile phones accessible from the very beginning of iPhones story. +[**"A Timeline of iOS Accessibility: It Started with 36 Seconds"**](https://www.macstories.net/stories/a-timeline-of-ios-accessibility-it-started-with-36-seconds/) is a marvellous research done by **Shelly Brisbin** that covers the path that Apple has been following to make their mobile phones accessible from the very beginning of iPhones story. @Image(source: 36-seconds, alt: "") ### Current State -From June 8, 2009 Apple hasn't stopped for a second to promote accessible design. [**Inclusivity**](https://www.apple.com/diversity/) is one of the core values the company has been always exposing and [**accessibility**](https://www.apple.com/accessibility/) is an immanent part of it. Aiming to make a product as universal so everyone can use it led Apple to unmeasurable efforts put to assistive technology support. +From June 8, 2009 Apple hasn't stopped for a second to promote **accessible design**. [**Inclusivity**](https://www.apple.com/diversity/) is one of the core values the company has been always exposing and [**accessibility**](https://www.apple.com/accessibility/) is an immanent part of it. Aiming to make a product as *universal* so everyone can use it led Apple to unmeasurable efforts put to assistive technology support. @Row { @Column { @@ -157,16 +157,26 @@ From June 8, 2009 Apple hasn't stopped for a second to promote accessible design As for today here is the list of all [**Accessible Features**]() on iOS. @Image(source: features-list, alt: "") -To see how these technologies personalise the user experience go to the settings and play around. Please consider that turning on some features like [**Switch Control**]() may be tricky to turn off, so make sure you are aware of what is going to happen when you toggle the settings. +To see how these technologies personalise the user experience go to the settings and play around. Please consider that turning on some features like [**Switch Control**]() may be tricky to turn off, so make sure you are *aware* of what is going to happen when you toggle the settings. @Image(source: settings-features, alt: "") -To know more about specific features, their concept and implementation visit the guides in [**Accessibility Feature**]() series. +To know more about *specific features*, their concepts and implementations visit the guides in [**Accessibility Feature**]() series. +@Links(visualStyle: list) { + - + - + - + - + - + - + - + - +} -### Community Trends +### Community Guidelines Finally, we came to the point where stating the purpose of this book is possible. [**iOS Accessibility Handbook**](https://vodgroup.github.io/AccessibilityDocumentation/documentation/iosaccessibilityhandbook) is a collection of guidelines of how to develop software for iOS which supports [**Accessible Features**]() and promotes [**accessible design**](). @Image(source: human-interface-guidelines, alt: "") -To dive into the process of developing accessible application open the [**Table of Contents**](https://vodgroup.github.io/AccessibilityDocumentation/tutorials/adaptionstrategy), which covers the practical side of the book. +To dive into the process of developing accessible applications open the [**Table of Contents**](https://vodgroup.github.io/AccessibilityDocumentation/tutorials/adaptionstrategy), which covers the *practical* side of the book. @Image(source: roadmap, alt: "") If you want to learn about accessibility or assistive technology first, take a look at articles from **General Knowledge** category. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md index 7a3887c..4776ec8 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md @@ -22,7 +22,7 @@ Make your iOS application accessible for everyone ## — What is this? -iOS Accessibility Handbook is an open-source **educational project** about making iOS applications *accessible*. Accessible application is such application that works with various *assistive technologies*, such as [**VoiceOver**](https://www.apple.com/accessibility/voiceover), [**Voice Control**](https://support.apple.com/en-us/HT210417) and [**Switch Control**](https://support.apple.com/en-us/HT201370), which enable *people with disabilities* use the application. +iOS Accessibility Handbook is an open-source **educational project** about making iOS applications *accessible*. Accessible application is such application that works with various *assistive technologies*, such as [**VoiceOver**](https://www.apple.com/accessibility/voiceover), [**Voice Control**](https://support.apple.com/en-us/HT210417) and [**Switch Control**](https://support.apple.com/en-us/HT201370), which enable **people with disabilities** use the application. @Image(source: features-1, alt: "") @Image(source: features-2, alt: "") @@ -35,7 +35,7 @@ This handbook provides *extended documentation* of [**Accessibility Features**]( In other words, materials here cover **everything one could ever need to know about accessibility on iOS**. ### Target Audience -The project is dedicated to help *developers*, *designers*, *researchers* and so on — in other words, to *everyone working with accessibility* on iOS. There is **no commercial underlayment** and the only reason the project exists is to popularise the topic and to *share* relevant real-life experience of contributing *accessibility professionals*. +The project is dedicated to help *developers*, *designers*, *testers*, *researchers* and *mere users* — in other words, to *everyone working with accessibility* on iOS. There is **no commercial underlayment** and the only reason the project exists is to popularise the topic and *share* relevant real-life experience of contributing *accessibility professionals*. ### Featured @Links(visualStyle: detailedGrid) { @@ -145,8 +145,10 @@ Reading the book one may sometimes notice screenshots of iOS applications with * ### Testing - +- - - +- - ### Maintenance diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/web-colors.png b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/web-colors.png index a2cd7ed..afa433e 100644 Binary files a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/web-colors.png and b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Resources/web-colors.png differ