Skip to content

Commit d2956a7

Browse files
committed
Refine issue templates for reporting problems, accessibility barriers, and improvement requests; enhance clarity and privacy guidance. Update README and SECURITY documents for better support and reporting processes; streamline support channels and response expectations in SUPPORT.md.
1 parent 4042968 commit d2956a7

10 files changed

Lines changed: 483 additions & 826 deletions

‎.github/MIGRATION-NOTES.md‎

Lines changed: 0 additions & 76 deletions
This file was deleted.

‎ACCESSIBILITY.md‎

Lines changed: 71 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,93 @@
11
# Accessibility
22

3-
We want everyone, including people with disabilities and people who use assistive technology, to be able to use and learn from this repository.
3+
We aim to make GC-STEM materials usable by everyone, including
4+
people with disabilities and people who use assistive technology.
45

5-
Accessibility is an ongoing part of course quality. Course materials are designed to support [WCAG 2.1 Level AA](https://www.w3.org/TR/WCAG21/), consistent with SNHU's current accessibility standard. Where practical, we also apply relevant [WCAG 2.2](https://www.w3.org/TR/WCAG22/) guidance. This is an accessibility goal, not a claim of verified conformance.
6-
7-
This document primarily addresses course materials created and maintained in this repository. GitHub is a third-party platform, and some aspects of its accessibility are outside the course team's control. If a GitHub accessibility barrier prevents you from completing a course task, use the reporting process below so that an appropriate alternative or workaround can be identified.
6+
Our accessibility target is Web Content Accessibility Guidelines
7+
(WCAG) 2.1 Level AA, consistent with SNHU's published guidance.
8+
Where practical, we also apply relevant WCAG 2.2 improvements.
9+
This target is not a claim that every resource has been verified
10+
to meet the standard.
811

912
## Table of Contents <!-- omit from toc -->
1013

11-
- [Accessibility](#accessibility)
12-
- [Accessibility Practices](#accessibility-practices)
13-
- [Known Limitations and Alternatives](#known-limitations-and-alternatives)
14-
- [Reporting an Accessibility Barrier](#reporting-an-accessibility-barrier)
15-
- [Contributors](#contributors)
16-
- [Additional Resources](#additional-resources)
14+
1. [Get Help with an Accessibility Barrier](#get-help-with-an-accessibility-barrier)
15+
2. [Helpful Reporting Details](#helpful-reporting-details)
16+
3. [Known Barriers and Alternatives](#known-barriers-and-alternatives)
17+
4. [Practices for Contributors](#practices-for-contributors)
18+
5. [Status](#status)
19+
20+
## Get Help with an Accessibility Barrier
21+
22+
If a file, tool, website, or activity makes required coursework
23+
difficult or impossible to complete, contact your instructor
24+
promptly using the private communication method listed in
25+
Brightspace.
26+
27+
You can also use [SNHU Accessibility Services](https://www.snhu.edu/about-us/accessibility)
28+
to find:
1729

18-
## Accessibility Practices
30+
- The Online Accessibility Center
31+
- Accommodation support
32+
- The university's accessibility barrier-reporting form
33+
- The formal accessibility grievance procedure
1934

20-
Course repository content should:
35+
You do not need to disclose a disability or diagnosis to report a
36+
barrier. Formal accommodation requests follow SNHU's accessibility
37+
services process.
2138

22-
* Use clear headings, lists, and descriptive link text.
23-
* Use plain language when possible and explain unfamiliar abbreviations and technical terms.
24-
* Provide meaningful alternative text for images.
25-
* Provide a text alternative for diagrams and other complex visual content.
26-
* Provide captions or transcripts for instructional audio and video.
27-
* Avoid using color alone to communicate meaning.
28-
* Use sufficient contrast for text, controls, diagrams, and other meaningful visual elements.
29-
* Ensure content remains usable when text is enlarged, spacing is increased, or the page is zoomed.
30-
* Use tables only for tabular data and include clear column headings.
31-
* Keep code examples readable and explain what they do and what successful output should look like.
32-
* Support keyboard use when an activity includes an interactive interface.
39+
If you choose to report a general repository barrier through
40+
GitHub Issues, describe the content or interaction involved.
41+
Do not post medical information, accommodation documents, grades,
42+
or other private information.
3343

34-
## Known Limitations and Alternatives
44+
## Helpful Reporting Details
3545

36-
{{SME TODO: Identify known accessibility barriers that could affect required course activities. For each barrier, document an available workaround or equally effective alternative. Remove this section only if known limitations and contingency procedures are documented elsewhere for the course.}}
46+
Share what you know:
3747

38-
## Reporting an Accessibility Barrier
48+
- What you were trying to do
49+
- The page, file, tool, or activity involved
50+
- What made it difficult or impossible
51+
- Whether it prevents you from completing a required task
52+
- Your browser, operating system, or assistive technology, if
53+
relevant and you are comfortable sharing it
3954

40-
If something in this repository prevents or makes it difficult for you to complete a course task:
55+
A short description is enough to begin. Screenshots, recordings,
56+
and technical details are optional.
4157

42-
* **Students:** Contact your instructor or use the [Student Support](https://github.com/GC-STEM/_core/wiki/Support-Student) resources listed for this course.
43-
* **Faculty and staff:** Report the problem through the repository's approved issue or support process.
58+
## Known Barriers and Alternatives
4459

45-
When possible, describe:
60+
Course maintainers should document known barriers and approved
61+
workarounds or equally effective alternatives in the course
62+
repository's README or required instructions.
4663

47-
* What you were trying to do.
48-
* What happened or what made the task difficult.
49-
* The page, file, or activity involved.
50-
* Your browser, operating system, or assistive technology, if relevant.
64+
If the documented options do not meet your needs, contact your
65+
instructor or SNHU Accessibility Services. This includes barriers
66+
in GitHub and other third-party tools.
5167

52-
You do **not** need to disclose a disability or diagnosis to report an accessibility barrier.
68+
## Practices for Contributors
5369

54-
## Contributors
70+
When creating or changing materials:
5571

56-
When adding or changing course materials, check accessibility as part of the normal review process. Pay particular attention to headings, links, images, diagrams, tables, multimedia, color and contrast, content resizing and reflow, keyboard access, and any student-facing interface.
72+
- Use descriptive headings, links, and plain language.
73+
- Explain unfamiliar terms and abbreviations.
74+
- Provide meaningful alternative text for informative images and
75+
text explanations for complex diagrams.
76+
- Provide accurate captions for instructional video, transcripts
77+
for audio, and descriptions of essential visual information.
78+
- Use readable contrast and communicate meaning through more than
79+
color alone.
80+
- Keep content usable when enlarged or viewed on a narrow screen.
81+
- Use tables for data, with clear headers.
82+
- Provide commands, code, and error messages as selectable text.
83+
- Explain what code examples do and what successful output looks like.
84+
- Check keyboard access for interactive activities.
5785

58-
Automated accessibility tools can help identify some problems, but they do not replace manual review or feedback from people who use assistive technology.
86+
Combine automated checks with manual review and feedback from
87+
people who use assistive technology.
5988

60-
## Additional Resources
89+
## Status
6190

62-
* [W3C Web Content Accessibility Guidelines (WCAG) 2.1](https://www.w3.org/TR/WCAG21/)
63-
* [W3C Web Content Accessibility Guidelines (WCAG) 2.2](https://www.w3.org/TR/WCAG22/)
64-
* [W3C Images Tutorial: Alt Decision Tree](https://www.w3.org/WAI/tutorials/images/decision-tree/)
65-
* [Open Source Guide: Accessibility Best Practices for Your Project](https://opensource.guide/accessibility-best-practices-for-your-project/)
66-
* [GitHub Docs: Adding an Accessibility Page to Your Repository](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-an-accessibility-page-to-your-repository)
67-
* [GitHub Accessibility Documentation](https://accessibility.github.com/documentation)
68-
* [GitHub Docs: Managing Accessibility Settings](https://docs.github.com/en/account-and-profile/how-tos/account-settings/managing-accessibility-settings)
69-
* [GitHub Accessibility: Using GitHub Repositories with a Screen Reader](https://accessibility.github.com/documentation/guide/repos/)
91+
This guidance is provisional while institutional review is pending.
92+
SNHU accessibility policies and approved accommodation processes
93+
continue to apply.

0 commit comments

Comments
 (0)