Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 10 additions & 13 deletions courses/qa/test-automation/week4/preparation.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,13 @@

## Reading List

> [!TIP]
> If you have some great external resources, you might want to create an external reading list for trainees to go through before the session.

Read/watch through this list of content before you come to the session:

- [`Title`](https://example.com/) by `Author`

## `Topic`

> [!TIP]
> Additionally, or instead of, you may wish to write your own pre-reading content. Be sure to keep it clear, consice, related to the learning goals - and think about using images and diagrams to make it easier to digest.

`Content goes here...`
Read through this list of content before you come to the session:

- [`What you need to become successful accessibility tester`](https://www.isoftstoneinc.com/insights/7-things-needed-to-become-a-successful-accessibility-tester/)
- [`WCAG 2.1 Compliance`](https://www.w3.org/WAI/WCAG22/quickref/?versions=2.1¤tsidebar=%23col_overview&showtechniques=…)
- [`Comprehensive accessibility checklist`](https://www.a11y-collective.com/blog/accessibility-checklist/)
- [`ARIA Guide`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA)
- [`VoiceOver Accessibility testing`](https://medium.com/@natalia.chugaievska/voiceover-accessibility-testing-a-practical-guide-for-designers-db0a8e7b2bfb)
- [`Using NVDA Screen Reader to Test Web Accessibility`](https://www.audioeye.com/post/nvda-screen-reader-web-accessibility/)
- [`NVDA configuration and shortcuts`](https://webaim.org/articles/nvda/)
- [`Five myths about accessible design`](https://www.a11y-collective.com/blog/five-myths-about-accessible-design/)
68 changes: 45 additions & 23 deletions courses/qa/test-automation/week4/session-plan.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,50 @@
# Session Plan

> [!TIP]
> The session plan is written to guide the mentor to prepare and run the session. Of course, trainees may come across and read this material. But it should be written as if you're speaking to a mentor.
- Introduction: What is Web Accessibility (WCAG) & Why It Matters (30 mins)
- What is Accessibility?
- Understanding WCAG (Web Content Accessibility Guidelines)
- Why accessibility matters
- Real‑world impact
- Legal & ethical responsibilities
- Business value
- Inclusive Design Patterns (40 mins)
- What is inclusive design?
- Designing for all users (visual, auditory, motor, cognitive)
- Common inclusive UI patterns
- Color contrast & typography
- Form labels & errors
- Focus indicators
- Responsive and flexible layouts
- Anti‑patterns (what to avoid)
- Development with Accessibility in Mind (45 mins)
- Semantic HTML and why it’s foundational
- ARIA basics & when not to use ARIA
- Keyboard-first development practices
- Focus management & skip links
- Designing components that are accessible from the start (buttons, modals, dropdowns, etc.)
- Manual Accessibility Checks (Keyboard Navigation & Screen Reader Basics) (40 mins)
- Keyboard-only navigation testing
- Tab order
- Focus trapping
- Interactive elements
- Screen reader introduction
- NVDA / VoiceOver basics
- Navigating landmarks, headings, and interactive controls
- Hands-on mini demo
- Automating Accessibility Checks with Playwright + Axe-core (30 mins)
- Why automation? What it can & cannot catch
- Setting up Axe-core with Playwright
- Running automated checks in tests
- Interpreting automated violation reports
- Analyzing and Reporting Accessibility Defects (25 mins)
- How to read WCAG success criteria
- Writing actionable accessibility bug reports
- Steps to reproduce
- Expected behavior vs. actual
- WCAG reference
- Severity & impact
- Prioritizing accessibility fixes

## Session Materials

> [!TIP]
> Previously used slides, docs or any other materials that future mentors could get value from should be listed here. If we don't have any (yet), this section can be removed.

These are some examples of previously created materials by mentors that you can use yourself, or for inspiration.

- [`Resource Name`, `@author`, `Team X`](https://example.com/)

## Session Outline

> [!TIP]
> Write a plan for the order of topics, points to cover, examples, timings, exercises and any other useful info to guide the session.

## Exercises

> [!TIP]
> Exercises might appear inside the Session Outline section if they are tightly integrated into the flow of the session. If you have more like a library of exercises that should be worked through in order, then you could also list them in a separate section here.

## Optional Exercises

> [!TIP]
> If you have some extra exercises that trainees can complete if they finish the rest, or want to push themselves, include them in this optional section.
In this session, you will learn the importance of web accessibility and how to test it both manually and through automation. We will cover WCAG standards, perform basic manual accessibility checks (keyboard navigation and screen reader basics), and automate accessibility testing using Playwright with Axe-core. This week also focuses on analyzing and reporting accessibility defects effectively.
Loading