Skip to content
Open
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
12775a1
Create accessible-pairing-sessions.md
ParisaTork May 29, 2023
6091039
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
f6cfe95
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
0b4119e
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
02fbbea
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
901d2e8
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
244f814
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
98fa111
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
dda1641
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
6617c9c
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
7342f06
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
c8f93f7
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
de13356
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
f271702
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
ff4de4c
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
5c631ef
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
447b573
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
dc8eb00
Update accessible-pairing-sessions.md
ParisaTork May 29, 2023
39216cf
Rename accessible-pairing-sessions.md to accessible-inclusive-pairing…
ParisaTork Jun 23, 2023
5c89b62
Update accessible-inclusive-pairing-sessions.md
ParisaTork Jun 23, 2023
8c515bd
Update accessible-inclusive-pairing-sessions.md
ParisaTork Jun 23, 2023
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
101 changes: 101 additions & 0 deletions accessible-inclusive-pairing-sessions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
# How to make pairing sessions more accessible and inclusive:

## Table of Contents
* [Detail](#detail)
* [Checklist](#checklist)

## Detail

>It's always best to ask a person about their specific, individual requirements. However, many employees may not be open about this information for various reasons. Moreover, more staff members have accessibility requirements than you might think, so it's wise to assume that the person you're pairing with has some sort of accessibility requirement.

>In terms of language, I could use 'senior' and 'junior' instead of 'teacher' and 'student', but I believe it's beneficial to encourage people at similar levels to teach each other how to write software.

## Scheduling the pairing session
* **Time** - Is the proposed time suitable for both the teacher and student? Do either of them have specific schedules due to caregiving responsibilities, gender-affirming care, disabilities, chronotypes (sleep-wake cycles), energy levels etc? Are both parties in relatively good health for them, both emotionally and physically? Are either of them overloaded with work or meetings?
* **Length of time** - How much time does each party need? Do they require extra time to learn or process information? Is there ample time for breaks?
* **Necessity** - Is the pairing session necessary / desired? Is pairing the ideal format for providing this information or would another format be preferred e.g. async?
* **Surroundings** - Besides time, are both the teacher and student in suitable surroundings for the pairing session? This includes a lack of background noise, a reliable WiFi connection etc.
* **Assistive technologies** - Do both parties have all the assistive technology they need, e.g. a virtual overlay, or does this need to be provided? Do they have any workarounds for this? Are there noticeable patterns in either of them, which could help both parties obtain help they didn't know they needed? Could they try out assistive technologies in the session to see if anything proves beneficial?
* **Calendar invites** - Does the calendar invite contain information about what will be covered in the pairing session for future reference? Are there clear goals for the session? Could these goals be divided into smaller sessions instead of one large session?
* **Number of people** - How many people need to be present? A 1:1 session would allow for a more in-depth exploration of the material, while a larger group might promote knowledge sharing and a greater variety of questions. N.B. Larger group discussion require more structure and time for signposting and summaries.
* **Recording/Transcription** - Will there be a recording or transcription for the meeting?
* **Meeting software** - Which meeting software will be used (see also below)?
* **Follow-up sessions** - Is there time for a follow-up session if the student wants to ask more questions? Or would it be better for them to pair with someone else to provide this opportunity at a later date?

## Consider the meeting software (video conferencing)
* Google Meet's closed captions are subpar, so the teacher might consider hosting the pairing session using Zoom or another superior alternative instead.
* **Why**: This is particularly important for people with disabilities, individuals for whom English is a second language, or those who rely on closed captions for other reasons.
* **Tip**: As the meeting host on Zoom, the teacher can click ‘Live Transcript’ and then ‘Enable Auto Transcription’.

## Preparing materials and questions in advance
* **For the teacher**: The teacher should try to provide the student with as much information as possible beforehand, e.g., steps that will be taken during the pairing session. This will allow the student to familiarise themselves with the steps on their own and ask the teacher learning questions during the pairing session itself. This information, whether in the form of a document or links to documentation, should be accessible e.g. readable by a screen reader, direct, uncomplicated language.
* **For the student**: The student should try to prepare questions for the teacher in advance of the session.
* **Why**: Compiling information benefits both the teacher and student, because it prompts them to think more carefully about what they are teaching/learning and provides them with material for further teaching/learning and documentation at a later date.

## Sensitive advice that optional prep is recommended
* When material is provided, the teacher should emphasise that reading the materials is optional and that there's no expectation to read the materials in advance. They can highlight the benefits of preparing before the pairing session, but should also be mindful that the individual may require flexibility due to responsibilities like caregiving or energy management.

## The pairing session itself
* **Communication** - The teacher can ensure that they are communicating information at an appropriate technical level, speed and style. Where possible, language should be direct and uncomplicated.
* **Active learning** - The teacher can ensure the student is engaged by asking them questions.
* **Check-ins** - The teacher can regularly check in to ensure that the student has the opportunity to ask questions.
* **Breaks** - The teacher and student can aim to have a break in the middle of the session by default and ask one another if they need additional breaks. They should both feel free to take impromptu breaks as needed.

Sometimes it might not be practical to ask questions:
* **Derailing** - The questions would derail (disrupt the original goal of) the session.
* **Too many people** - There are multiple participants in the session.
* **Deadlines** - The pairing sessions involves a task that needs to be completed in a short time-frame.
* **N.B.** This is why considering the structure of the pairing sessions beforehand is so important.

If this is the case, then:
* **1:1s** - The teacher should try to schedule a 1:1, where the student has the opportunity to ask questions.
* **Delegation** - If the teacher does not have time or is taking leave, they should delegate this task to someone else e.g. a developer they know is familiar with the task, the student’s mentor (if they don’t have one, they should be signed up to a mentorship or mini-mentorship scheme) or ask for someone of the student’s choice.
* **N.B.** This should also be arranged in cases when questioning was planned, but disrupted in some way.

## Summary/Further Resources
* **For the teacher**: The teacher should aim to provide a summary of the key points of the pairing sessions through a preferred communication channel e.g. chat (ideally immediately) afterwards. They can also provide additional resources that the student might find helpful.
* **For the student**: The student should also feel encouraged to give a summary of the session and provide the teacher with any resources they find useful on the topic.

## Success-measuring
* The teacher and student should decide how success will be evaluated from the sessions:
* **Completion of task** - Is it by the completion of the pull request / code review?
* **Quizzing** - Is it by the teacher verbally quizzing the student at the end of the session on the key points or at a later date?
* **Documenting** - Is it by asking the student to write documentation or flashcards about the pairing session afterwards?
* **Feedback** - Can the teacher and the student provide each other feedback on the pairing session to see what went well and what could improve?

## Opportunities to improve documentation and working processes
* **Documentation** - Are there opportunities to improve documentation?
* **Working practices** - Can working processes be improved?
* **Inclusivity/accessibility** - Is there room to improve inclusivity? Has the pairing session prompted more questions about the software's accessibility and how it may affect users? If so, do any actions need to be taken to address this?

## Checklist
- [ ] Scheduling the pairing session
- [ ] Checking suitable time, length, necessity and surroundings
- [ ] Checking suitable assistive technology
- [ ] Providing calendar invite information and structure of sessions
- [ ] Determining if 1:1 or group session
- [ ] Determining if recording/transcription
- [ ] Checking if follow-up is possible
- [ ] Choosing meeting software
- [ ] Preparing materials and questions in advance
- [ ] Advance information for student
- [ ] Advance questions for teacher
- [ ] Sensitive advice that optional prep is recommended
- [ ] Pairing session
- [ ] Ensuring the right communication
- [ ] Active learning/questioning during the pairing session
- [ ] Regular check-in for questions
- [ ] Arranging breaks
- [ ] Organising a follow-up session if questioning isn't possible / disrupted
- [ ] Scheduling a 1:1 session for questioning
- [ ] Delegation of 1:1 session to someone else if necessary
- [ ] Providing a summary and further resources
- [ ] Measuring success
- [ ] Identifying opportunities to improve documentation, working processes and inclusivity