diff --git a/.swiftpm/xcode/xcshareddata/xcschemes/iOSAccessibilityHandbook.xcscheme b/.swiftpm/xcode/xcshareddata/xcschemes/iOSAccessibilityHandbook.xcscheme new file mode 100644 index 0000000..23ebf89 --- /dev/null +++ b/.swiftpm/xcode/xcshareddata/xcschemes/iOSAccessibilityHandbook.xcscheme @@ -0,0 +1,67 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial index 039b555..6e7835c 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Adaption/AdoptionGuide.tutorial @@ -1,31 +1,29 @@ @Tutorials(name: "AdoptionGuide") { - @Intro(title: "iOS Accessibility Adoption Guide") { - Here is the **roadmap** of what one can do to make their application *accessible*. - - ### Essentiality - The *level of importance* — whether accessibility adoption is **basic** or **advanced** — decided by its requirement for assistive technologies to *simply* function. To make the accessible experience more *delightful* some **additional tinkering** has to be done. - - ### Familiarity - If you are not familiar with the **related terminology**, see the **introductory pages**. + @Intro(title: "iOS Accessibility Guide") { + This collection of guides may be perceived as a complete course on accessibility of iOS apps: from the very basics to professional system design solution. + + ### Course plan + The course starts with the tasks essential for implementation -- without them the assistive technology won't simply function within the app. Volume by volume the broadness of topics and cost of integration will rise. + + ### Tutorials layout + Each tutorial from every chapter covers the theory behind the given topic and provides sufficient amount of real-life examples, additional resources and source-code for both UIKit and SwiftUI so you can apply new knowledge right away. - @Links(visualStyle: detailedGrid) { - - - - - } + ### Let's dive in! - Otherwise you may start straight from the first guide or a tutorial of your particular interest — the separated materials are *self-sufficient*. + @Image(source: placeholder-image, alt: "") } @Volume(name: "Integrating interfaces with accessibility") { - This volume covers tasks crucial for implementation. Unsolved issues from the inner chapters exclude users of assistive technology. + This volume covers the **tasks crucial for implementation**: unsolved issues from the inner chapters *exclude* users of [**assistive technology**](). @Image(source: placeholder-image.png, alt: "") @Chapter(name: "Expose interfacial data") { @Image(source: chapter-placeholder.png, alt: "") - Describe every non-decorative element sufficiently so both users and assistive technology know what's happening. + First of all, every functional element of the interface has to be sufficiently *described*. + @TutorialReference(tutorial: "doc:AccessibleUI") @TutorialReference(tutorial: "doc:AccessibilityAttributes") @TutorialReference(tutorial: "doc:Traits") @@ -36,7 +34,7 @@ @Chapter(name: "Ensure that navigation is possible") { @Image(source: chapter-placeholder.png, alt: "") - Integrate alternative controlling of both direct and indirect selection so users of assistive technology can freely navigate the app. + Secondly, to reconnect the elements into a integral interface certain alternative controlling options have to be enabled. @TutorialReference(tutorial: "doc:OnScreen-Navigation") @TutorialReference(tutorial: "doc:FocusManagement") @@ -46,7 +44,7 @@ @Chapter(name: "Secure user scenarios") { @Image(source: chapter-placeholder.png, alt: "") - Ensure that users of assistive technology are able to complete the tasks they are supposed to achieve without having to deal with misleading layouts. + Lastly, to make sure that the users of assistive technology are able to complete the tasks they are supposed to achieve review the layout of the accessible interface. @TutorialReference(tutorial: "doc:ControlHierarchy") @TutorialReference(tutorial: "doc:Containers") @@ -60,7 +58,7 @@ @Image(source: placeholder-image.png, alt: "") - @Chapter(name: "Accessible Description") { + @Chapter(name: "Accessible description") { @Image(source: chapter-placeholder.png, alt: "") **Describe the accessible interface** to that extent so its users have **less ambiguity in its interpretation**. @@ -71,7 +69,7 @@ @TutorialReference(tutorial: "doc:AlternativeDescription") } - @Chapter(name: "Accessible Controls") { + @Chapter(name: "Accessible controls") { Implement **alternative accessible controlling options** to make the experience **smoother**. @TutorialReference(tutorial: "doc:Rotor") @TutorialReference(tutorial: "doc:CustomActions") @@ -79,7 +77,7 @@ @Image(source: chapter-placeholder.png, alt: "") } - @Chapter(name: "Accessible Navigation") { + @Chapter(name: "Accessible navigation") { @Image(source: chapter-placeholder.png, alt: "") Develop **sufficient paths** to enable people **conveniently complete the tasks** they are supposed to. @@ -90,7 +88,7 @@ @TutorialReference(tutorial: "doc:ErrorPrevention") } - @Chapter(name: "Accessible Appearance") { + @Chapter(name: "Accessible appearance") { @Image(source: chapter-placeholder.png, alt: "") Make your **GUI easier to be visually comprehended** for people with visual or mental impairments. @@ -101,7 +99,7 @@ } } - @Volume(name: "Extend On Enterprise Processes") { + @Volume(name: "Extend on enterprise processes") { This volume provides additional insights on the topic of accessibility and its integration at various stages of the product's **life cycle**. diff --git a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md index 38425c8..44f2157 100644 --- a/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md +++ b/Sources/iOSAccessibilityHandbook/iOSAccessibilityHandbook.docc/Pages/Introduction/iOSAccessibility.md @@ -29,6 +29,7 @@ There are many reasons why one would want to *include* more people — from stra @Image(source: fifteen-percent, alt: "") ## Computer Accessibility +## миша привет Computer accessibility, often referred to as **a11y**, includes a wide range of solutions that are aimed to enhance approachability of digital products. It can be done by using **assistive technology**, which is specialised *software* or *hardware*, or a *combination* of both. @Image(source: a11y, alt: "")