Skip to content

Commit 944e3af

Browse files
committed
Polish: remove em/en-dashes, fix http to https, remove sign language placeholder, remove practice repo link, fix registration URLs, remove emojis from workflow
1 parent 358bb07 commit 944e3af

File tree

147 files changed

+5154
-5155
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

147 files changed

+5154
-5155
lines changed

.github/ISSUE_TEMPLATE/accessibility-bug.yml

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,15 @@ body:
1515
label: Type of Accessibility Issue
1616
description: Which category best describes what you encountered?
1717
options:
18-
- Keyboard navigation cannot reach or operate a control with keyboard only
19-
- Screen reader missing, incorrect, or confusing announcements
20-
- Focus management focus jumps unexpectedly or is lost
21-
- Heading structure headings skipped, missing, or in wrong order
22-
- Link / button labels unlabeled, ambiguous, or "click here"
23-
- Color / contrast text or controls are hard to distinguish
24-
- Images missing or inadequate alternative text
25-
- Forms fields not labeled or error messages not announced
26-
- Time limits content changes or disappears before I can act
18+
- Keyboard navigation - cannot reach or operate a control with keyboard only
19+
- Screen reader - missing, incorrect, or confusing announcements
20+
- Focus management - focus jumps unexpectedly or is lost
21+
- Heading structure - headings skipped, missing, or in wrong order
22+
- Link / button labels - unlabeled, ambiguous, or "click here"
23+
- Color / contrast - text or controls are hard to distinguish
24+
- Images - missing or inadequate alternative text
25+
- Forms - fields not labeled or error messages not announced
26+
- Time limits - content changes or disappears before I can act
2727
- Other (describe below)
2828
validations:
2929
required: true
@@ -89,7 +89,7 @@ body:
8989
id: os
9090
attributes:
9191
label: Operating System and Version
92-
description: For example Windows 11, macOS Sonoma 14.3, iOS 17.2
92+
description: For example - Windows 11, macOS Sonoma 14.3, iOS 17.2
9393
placeholder: Windows 11
9494
validations:
9595
required: true
@@ -98,7 +98,7 @@ body:
9898
id: wcag
9999
attributes:
100100
label: Relevant WCAG Success Criterion (if known)
101-
description: If you know which WCAG criterion applies, select it. Leave blank if unsure the team will assess.
101+
description: If you know which WCAG criterion applies, select it. Leave blank if unsure - the team will assess.
102102
options:
103103
- "1.1.1 Non-text Content (alt text)"
104104
- "1.3.1 Info and Relationships (semantic structure)"
@@ -135,6 +135,6 @@ body:
135135
id: additional
136136
attributes:
137137
label: Additional Context
138-
description: Anything else that might help screenshots with alt text, screen reader log excerpts, or links to related issues.
138+
description: Anything else that might help - screenshots with alt text, screen reader log excerpts, or links to related issues.
139139
validations:
140140
required: false

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
blank_issues_enabled: false
22
contact_links:
3-
- name: "Register for GIT Going with GitHub (March 67, 2026)"
4-
url: https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+
3+
- name: "Register for GIT Going with GitHub (March 6-7, 2026)"
4+
url: https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+-+March+2026
55
about: Sign up for the two-day accessible open source workshop by BITS. Free, online, 75 seats.
6-
- name: GitHub Skills Introduction to GitHub
6+
- name: GitHub Skills - Introduction to GitHub
77
url: https://github.com/skills/introduction-to-github
8-
about: Interactive module branches, commits, pull requests, and merge. Mona guides you step by step.
9-
- name: GitHub Skills Communicate Using Markdown
8+
about: Interactive module - branches, commits, pull requests, and merge. Mona guides you step by step.
9+
- name: GitHub Skills - Communicate Using Markdown
1010
url: https://github.com/skills/communicate-using-markdown
11-
about: Interactive module headings, emphasis, links, code blocks, task lists, and tables.
12-
- name: GitHub Skills Review Pull Requests
11+
about: Interactive module - headings, emphasis, links, code blocks, task lists, and tables.
12+
- name: GitHub Skills - Review Pull Requests
1313
url: https://github.com/skills/review-pull-requests
14-
about: Interactive module Mona creates a real PR in your account for you to review.
14+
about: Interactive module - Mona creates a real PR in your account for you to review.
1515
- name: Workshop Documentation
1616
url: https://bits-acb.github.io/git-going-with-github/
17-
about: Full workshop guide start here if you are new to this repository.
18-
- name: Discussion Forum Questions, Introductions, Ideas
17+
about: Full workshop guide - start here if you are new to this repository.
18+
- name: Discussion Forum - Questions, Introductions, Ideas
1919
url: https://github.com/BITS-ACB/git-going-with-github/discussions
2020
about: Ask questions, connect with other participants, and share ideas before, during, and after the workshop.

.github/ISSUE_TEMPLATE/feature-request.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ body:
4545
id: contribution
4646
attributes:
4747
label: Are you able to help implement this?
48-
description: No commitment required just helps with planning.
48+
description: No commitment required - just helps with planning.
4949
options:
5050
- label: Yes, I can open a pull request with the change
5151
- label: I can provide research, examples, or feedback but cannot write the change

.github/ISSUE_TEMPLATE/workshop-registration.yml

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
name: "Workshop Registration GIT Going with GitHub"
2-
description: "Register for the GIT Going with GitHub workshop (March 67, 2026)"
3-
title: "[REGISTER] GIT Going with GitHub March 2026"
1+
name: "Workshop Registration - GIT Going with GitHub"
2+
description: "Register for the GIT Going with GitHub workshop (March 6-7, 2026)"
3+
title: "[REGISTER] GIT Going with GitHub - March 2026"
44
labels: ["registration"]
55
assignees: []
66
body:
@@ -10,11 +10,11 @@ body:
1010
## Welcome! You are registering for GIT Going with GitHub.
1111
1212
**Dates:** Friday, March 6 and Saturday, March 7, 2026
13-
**Time:** 12:00 PM 8:00 PM Eastern (both days)
13+
**Time:** 12:00 PM - 8:00 PM Eastern (both days)
1414
**Cost:** Free
1515
**Capacity:** 75 participants
1616
17-
Filling out this form is your first GitHub interaction and it counts. You are already learning. All fields below are accessible with NVDA, JAWS, and VoiceOver.
17+
Filling out this form is your first GitHub interaction - and it counts. You are already learning. All fields below are accessible with NVDA, JAWS, and VoiceOver.
1818
1919
- type: input
2020
id: first-name
@@ -56,12 +56,12 @@ body:
5656
id: proficiency
5757
attributes:
5858
label: GitHub Proficiency Level
59-
description: How would you describe your current experience with GitHub? There is no wrong answer this helps us prepare the right level of support for you.
59+
description: How would you describe your current experience with GitHub? There is no wrong answer - this helps us prepare the right level of support for you.
6060
options:
61-
- "Brand new I have never used GitHub before"
62-
- "Beginner I have a GitHub account but have not done much with it"
63-
- "Intermediate I have created repositories, filed issues, or opened pull requests"
64-
- "Experienced I use GitHub regularly for projects or work"
61+
- "Brand new - I have never used GitHub before"
62+
- "Beginner - I have a GitHub account but have not done much with it"
63+
- "Intermediate - I have created repositories, filed issues, or opened pull requests"
64+
- "Experienced - I use GitHub regularly for projects or work"
6565
validations:
6666
required: true
6767

@@ -85,9 +85,8 @@ body:
8585
label: Questions or Accommodations
8686
description: Any questions about the workshop, or accommodations we should arrange? Leave blank if none.
8787
placeholder: |
88-
I need a sign language interpreter.
8988
Can I attend only Day 1?
90-
I use a refreshable braille display will that work?
89+
I use a refreshable braille display - will that work?
9190
validations:
9291
required: false
9392

.github/README.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -160,10 +160,10 @@ Adjust PR thresholds and challenge lists as needed.
160160
### Validation Rules (`.github/scripts/validate-pr.js`)
161161

162162
Customize checks:
163-
- `checkIssueReference()` Require issue link patterns
164-
- `checkDescription()` Minimum character count (default: 50)
165-
- `checkFileLocation()` Allowed directories (default: learning-room/)
166-
- `validateMarkdownAccessibility()` A11y rules (headings, links, alt text)
163+
- `checkIssueReference()` - Require issue link patterns
164+
- `checkDescription()` - Minimum character count (default: 50)
165+
- `checkFileLocation()` - Allowed directories (default: learning-room/)
166+
- `validateMarkdownAccessibility()` - A11y rules (headings, links, alt text)
167167

168168
Add new validation functions to `required` or `suggestions` arrays.
169169

@@ -371,16 +371,16 @@ Edit `.github/data/challenge-progression.json`:
371371
## Documentation Map
372372

373373
**For Students:**
374-
- [Automation Guide](../learning-room/AUTOMATION.md) How bot works, interpreting feedback
375-
- [Learning Paths](docs/LEARNING_PATHS.md) Skill progression, challenge details
376-
- [Challenges List](../learning-room/docs/CHALLENGES.md) Available challenges
377-
- [Group Challenges](../learning-room/docs/GROUP_CHALLENGES.md) Collaborative exercises
374+
- [Automation Guide](../learning-room/AUTOMATION.md) - How bot works, interpreting feedback
375+
- [Learning Paths](docs/LEARNING_PATHS.md) - Skill progression, challenge details
376+
- [Challenges List](../learning-room/docs/CHALLENGES.md) - Available challenges
377+
- [Group Challenges](../learning-room/docs/GROUP_CHALLENGES.md) - Collaborative exercises
378378

379379
**For Facilitators:**
380-
- [Implementation Guide](docs/IMPLEMENTATION_GUIDE.md) Setup instructions
381-
- [Facilitator Guide](../FACILITATOR.md) Workshop facilitation (includes automation section)
382-
- [Workflow Files](workflows/) Automation source code
383-
- [Data Files](data/) Configuration (roster, progression)
380+
- [Implementation Guide](docs/IMPLEMENTATION_GUIDE.md) - Setup instructions
381+
- [Facilitator Guide](../FACILITATOR.md) - Workshop facilitation (includes automation section)
382+
- [Workflow Files](workflows/) - Automation source code
383+
- [Data Files](data/) - Configuration (roster, progression)
384384

385385
---
386386

@@ -424,11 +424,11 @@ Found a bug? Have a suggestion?
424424

425425
This automation system was designed with these principles:
426426

427-
**Accessibility First** Fully screen reader accessible
428-
**Educational Focus** Teaches, doesn't just check
429-
**Human-Centered** Augments, not replaces, human review
430-
**Professional Experience** Mirrors real CI/CD workflows
431-
**Community Building** Encourages collaboration and support
427+
**Accessibility First** - Fully screen reader accessible
428+
**Educational Focus** - Teaches, doesn't just check
429+
**Human-Centered** - Augments, not replaces, human review
430+
**Professional Experience** - Mirrors real CI/CD workflows
431+
**Community Building** - Encourages collaboration and support
432432

433433
Built for the Open Source Assistive Technology Hackathon workshop.
434434

.github/agents/analytics.agent.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ tools:
66
- fetch
77
---
88

9-
You are a team analytics agent for open source maintainers and contributors. You surface patterns in contribution data that are difficult to see by manually reading GitHub Insights and you present them in a format navigable by screen reader.
9+
You are a team analytics agent for open source maintainers and contributors. You surface patterns in contribution data that are difficult to see by manually reading GitHub Insights - and you present them in a format navigable by screen reader.
1010

1111
## Behavior
1212

@@ -29,7 +29,7 @@ When asked about review times:
2929
When asked about frequently changed files:
3030
- Identify files changed in more than 30% of recent commits
3131
- Note: high-churn files may indicate instability, unclear ownership, or areas needing refactoring
32-
- Do not make judgments report what the data shows
32+
- Do not make judgments - report what the data shows
3333

3434
### Contributor Distribution
3535

@@ -46,10 +46,10 @@ When asked to summarize contribution during a workshop or event:
4646
## Output Format
4747

4848
```
49-
## Analytics Report [repository] [time window]
49+
## Analytics Report - [repository] - [time window]
5050
5151
### Summary
52-
[23 sentences characterizing the period]
52+
[2-3 sentences characterizing the period]
5353
5454
### Contribution Volume
5555
- Commits: [N]
@@ -63,7 +63,7 @@ When asked to summarize contribution during a workshop or event:
6363
- Unique PR authors: [N]
6464
- Unique reviewers: [N]
6565
Top contributors:
66-
1. [username] [N] commits, [N] PRs
66+
1. [username] - [N] commits, [N] PRs
6767
2. ...
6868
6969
### Review Health
@@ -72,7 +72,7 @@ Top contributors:
7272
- PRs waiting > 7 days: [N] ([list titles if ≤ 5])
7373
7474
### Frequently Changed Files
75-
1. [filename] changed in [N]% of commits
75+
1. [filename] - changed in [N]% of commits
7676
2. ...
7777
7878
### Notes
@@ -81,6 +81,6 @@ Top contributors:
8181

8282
## Accessibility Requirements
8383

84-
- Never use tables in the output screen reader navigation through data tables is slower than labeled lists
85-
- Label every number never output a bare number without context
84+
- Never use tables in the output - screen reader navigation through data tables is slower than labeled lists
85+
- Label every number - never output a bare number without context
8686
- Use heading level 2 for the report title, level 3 for each section

.github/agents/daily-briefing.agent.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: daily-briefing
3-
description: Morning situation report sweeps your repositories and surfaces what needs your attention today
3+
description: Morning situation report - sweeps your repositories and surfaces what needs your attention today
44
tools:
55
- githubRepo
66
- fetch
@@ -25,10 +25,10 @@ When a user asks for a morning briefing, a daily summary, or asks "what needs my
2525

2626
## Output Format
2727

28-
Use this structure every time. Screen reader users navigate by heading maintain this hierarchy precisely.
28+
Use this structure every time. Screen reader users navigate by heading - maintain this hierarchy precisely.
2929

3030
```
31-
## Morning Briefing [Date]
31+
## Morning Briefing - [Date]
3232
3333
### Needs Your Action
3434
@@ -47,7 +47,7 @@ Use this structure every time. Screen reader users navigate by heading — maint
4747
[List each issue: title, number, repository, labels]
4848
4949
#### Your PRs With New Activity
50-
[List each PR: title, number, repository, what changed new comment, review submitted, etc.]
50+
[List each PR: title, number, repository, what changed - new comment, review submitted, etc.]
5151
5252
#### Security and Dependabot Alerts
5353
[List any alerts: repository, type, severity]
@@ -59,9 +59,9 @@ Use this structure every time. Screen reader users navigate by heading — maint
5959
## Accessibility Requirements
6060

6161
- Use heading level 2 for "Morning Briefing", level 3 for sections, level 4 for subsections
62-
- Never use bare URLs always use descriptive link text followed by the URL in parentheses
63-
- If a list is empty, say explicitly "None" do not omit the section
64-
- Do not use tables for the briefing output lists are more predictable to navigate
62+
- Never use bare URLs - always use descriptive link text followed by the URL in parentheses
63+
- If a list is empty, say explicitly "None" - do not omit the section
64+
- Do not use tables for the briefing output - lists are more predictable to navigate
6565

6666
## Tone
6767

0 commit comments

Comments
 (0)