Skip to content

Commit

Permalink
some new testing + lil remarks
Browse files Browse the repository at this point in the history
  • Loading branch information
crescentheaded committed Mar 26, 2024
1 parent 5da31f3 commit a084dae
Show file tree
Hide file tree
Showing 9 changed files with 92 additions and 12 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -121,8 +121,10 @@
How to test accessible apps.
<doc:AccessibilityQualityAssurance>

@TutorialReference(tutorial: "doc:AccessibilityChecklists")
@TutorialReference(tutorial: "doc:AccessibilityInspector")
@TutorialReference(tutorial: "doc:UnitTesting")
@TutorialReference(tutorial: "doc:SnapshotTesting")
@TutorialReference(tutorial: "doc:UITesting")
}

Expand Down
Original file line number Diff line number Diff line change
@@ -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#>)
}
}
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
https://www.deque.com/axe/devtools/mobile-accessibility/
}

@Intro(title: "UI Testing") {
@Intro(title: "UI Accessibility Testing") {
Михаил Рубанов знает.
}

Expand Down
Original file line number Diff line number Diff line change
@@ -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#>)
}
}
}
}
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
@Tutorial(time: 20) {
@Intro(title: "Unit Testing") {
@Intro(title: "Unit Accessibility Testing") {
Михаил Рубанов знает.
}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@ container
layout
control
element
focus
label
picker
slider
segmented control
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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**](<doc:AccessibleDesign>) that support the usage of [**Accessibility Features**](<doc:AccessibilityFeatures>) 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 {
Expand Down Expand Up @@ -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**](<doc:AccessibilityFeatures>) 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**](<doc:SwitchControl>) 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**](<doc:SwitchControl>) 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**](<doc:AccessibilityFeatures>) series.
To know more about *specific features*, their concepts and implementations visit the guides in [**Accessibility Feature**](<doc:AccessibilityFeatures>) series.
@Links(visualStyle: list) {
- <doc:VoiceOver>
- <doc:VoiceControl>
- <doc:SwitchControl>
- <doc:DynamicType>
- <doc:FullKeyboardAccess>
- <doc:AssistiveTouch>
- <doc:aGuidedAccess>
- <doc:AssistiveAccess>
}

### 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**](<doc:AccessibilityFeatures>) and promotes [**accessible design**](<doc:AccessibleDesign>).
@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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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: "")

Expand All @@ -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) {
Expand Down Expand Up @@ -145,8 +145,10 @@ Reading the book one may sometimes notice screenshots of iOS applications with *

### Testing
- <doc:AccessibilityQualityAssurance>
- <doc:AccessibilityChecklists>
- <doc:UITesting>
- <doc:UnitTesting>
- <doc:SnapshotTesting>
- <doc:AccessibilityInspector>

### Maintenance
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit a084dae

Please sign in to comment.