From 1d6a43f92a64c64ffc960b5220c79dad03bbbdfc Mon Sep 17 00:00:00 2001 From: "C." Date: Tue, 25 Jun 2024 08:31:20 +0300 Subject: [PATCH] code done --- .../Theory/AccessibilityInCode.md | 21 +++++++++++++++++-- .../Pages/iOSAccessibilityHandbook.md | 9 ++++---- 2 files changed, 24 insertions(+), 6 deletions(-) diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/AccessibilityInCode.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/AccessibilityInCode.md index 6094535..8c2dd30 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/AccessibilityInCode.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/Theory/AccessibilityInCode.md @@ -116,6 +116,23 @@ Accessibility representation is in essence an **accessible description** and **a ### Accessibility description For example, accessibility API has to know **certain data** about the interface to be able to work with it. Any accessibility feature has to be provided with **everything needed** to do its job. -Otherwise it simply won't work. Or will **wrongly behave**, which is *worse* than not working at all. +Otherwise it simply **won't work**. Or will **wrongly behave**, which is *worse* than not working at all. + +## Tutorials start here +We won't let it happen though. The book is intended to teach how to **adopt accessibility**. To make our job **uncompromisable**, we are going to study: +1) what **properties** of an interface contribute to accessibility; +2) how to **design interfaces** that exhibit them; +3) how to use this **semantic information** in order to provide **accessible experience** for *both* users and assistive technology. + +Sounds overwhelming? There is a lot to learn indeed. + +But the program was designed to build a **fundamental understanding** of digital accessibility practices. Consistent and comprehensible guidance on **applying this knowledge to iOS** is merely a bonus. + +> Note: As for the moment, **none of the contributors are affiliated with Apple**. Despite our goal to create seamless platform experience by the use of **native** solutions, do not forget that the resources here reflect **community knowledge** at the first place. + +### What's next +Ready for the action? Let's get started. +@Links(visualStyle: detailedGrid) { + - +} -## Wrap-up diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md index c2af3e9..c6c3157 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/iOSAccessibilityHandbook.md @@ -47,9 +47,10 @@ In other words, materials here cover **everything one could ever need to know ab ### Target audience The project is dedicated to help *developers*, *designers*, *testers*, *researchers* and *mere users* — in other words, **everyone dealing with accessibility** on iOS. -There is **no commercial underlayment**. The project is **non-profit** and the only reason *why* exists is to **popularise the topic** and **share the relevant experience** of its contributors. - ## Contributors + +> Note: [**iOS Accessibility Handbook**]() has **no commercial underlayment**. The project is **non-profit** and the only reason *why* exists is to **popularise the topic** and **share the relevant experience** of its contributors. + @Row(numberOfColumns: 2) { @Column { ### Mikhail Rubanov @@ -64,7 +65,7 @@ There is **no commercial underlayment**. The project is **non-profit** and the o ## About the website -**iOS Accessibility Handbook** is essentially a **complete course** of [**digital accessibility**]() best practices from the perspective of iOS development. +**iOS Accessibility Handbook** is essentially a **complete course** of [**digital accessibility**]() best practices from the *perspective* of iOS development. @Image(source: book-content, alt: "") To know more about the *curriculum* visit the [**Table of Contents**]() page. @@ -74,7 +75,7 @@ At the moment the project is a **[DocC](https://www.swift.org/documentation/docc To **contribute** to the project visit its **repository on [GitHub](https://github.com/VODGroup/AccessibilityDocumentation)** and see the How to Help the Project **instruction**. -## Assets +## Course assets ### VoiceOver Designer Reading the book you may notice **screenshots of iOS applications with mark-ups** related to [**accessibility description**]() over them. @Image(source: "vod-sample", alt: "-")