From 356ae6bebfb9fa5b971d8542ceba407d99f11fba Mon Sep 17 00:00:00 2001 From: Silas Santini <70163606+pancakereport@users.noreply.github.com> Date: Thu, 11 Sep 2025 15:38:34 -0700 Subject: [PATCH 1/3] ordering --- course-software/course-site.md | 2 +- course-software/edstem.md | 2 +- course-software/gradescope/index.md | 2 +- course-software/notebook-accessibility.md | 8 ++++++++ course-software/otter/index.md | 2 +- course-software/slack.md | 2 +- 6 files changed, 13 insertions(+), 5 deletions(-) create mode 100644 course-software/notebook-accessibility.md diff --git a/course-software/course-site.md b/course-software/course-site.md index 801f5b1..371c177 100644 --- a/course-software/course-site.md +++ b/course-software/course-site.md @@ -2,7 +2,7 @@ layout: page title: Course Webpages parent: Course Software -nav_order: 3 +nav_order: 5 --- # Course Webpages diff --git a/course-software/edstem.md b/course-software/edstem.md index e010a77..7b7aa41 100644 --- a/course-software/edstem.md +++ b/course-software/edstem.md @@ -2,7 +2,7 @@ layout: page title: EdStem parent: Course Software -nav_order: 4 +nav_order: 6 published: true --- diff --git a/course-software/gradescope/index.md b/course-software/gradescope/index.md index 96e9a6f..bfa4205 100644 --- a/course-software/gradescope/index.md +++ b/course-software/gradescope/index.md @@ -2,7 +2,7 @@ layout: page title: Gradescope parent: Course Software -nav_order: 1 +nav_order: 2 --- # Seamless Learning diff --git a/course-software/notebook-accessibility.md b/course-software/notebook-accessibility.md new file mode 100644 index 0000000..dc813f4 --- /dev/null +++ b/course-software/notebook-accessibility.md @@ -0,0 +1,8 @@ +--- +layout: page +title: Notebook Accessibility +parent: Course Software +nav_order: 4 +--- + +# Jupyter Notebook Accessibility \ No newline at end of file diff --git a/course-software/otter/index.md b/course-software/otter/index.md index a94c08d..e5d488f 100644 --- a/course-software/otter/index.md +++ b/course-software/otter/index.md @@ -1,7 +1,7 @@ --- layout: page title: Otter Grader -nav_order: 2 +nav_order: 3 parent: Course Software has_toc: true --- diff --git a/course-software/slack.md b/course-software/slack.md index eeeaf96..948d0b4 100644 --- a/course-software/slack.md +++ b/course-software/slack.md @@ -2,7 +2,7 @@ layout: page title: Slack parent: Course Software -nav_order: 5 +nav_order: 7 --- # Slack From d84b3dfdf2f2282a1f5f16d3d08727c23446e936 Mon Sep 17 00:00:00 2001 From: Silas Santini <70163606+pancakereport@users.noreply.github.com> Date: Thu, 11 Sep 2025 15:57:55 -0700 Subject: [PATCH 2/3] notebook a11y page --- assets/images/a11y-icon.png | Bin 0 -> 5259 bytes course-software/notebook-accessibility.md | 20 +++++++++++++++++++- 2 files changed, 19 insertions(+), 1 deletion(-) create mode 100644 assets/images/a11y-icon.png diff --git a/assets/images/a11y-icon.png b/assets/images/a11y-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..fd4b3ca50a625fe436165eeccbce8ff293617c14 GIT binary patch literal 5259 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 Nj)tLn%`M01{{fpIT(kfH literal 0 HcmV?d00001 diff --git a/course-software/notebook-accessibility.md b/course-software/notebook-accessibility.md index dc813f4..141e9fb 100644 --- a/course-software/notebook-accessibility.md +++ b/course-software/notebook-accessibility.md @@ -5,4 +5,22 @@ parent: Course Software nav_order: 4 --- -# Jupyter Notebook Accessibility \ No newline at end of file +# Jupyter Notebook Accessibility + +## Jupyter Notebook Accessibility Checker + +The DataHub team developed an [accessibility checker](https://github.com/berkeley-dsep-infra/jupyterlab-a11y-checker) for Jupyter Notebooks. This checker can identify and either suggest fixes for accessibility issues or provide an interface for you to fix issues yourself. A list of the accessibility issues this checker can aid with is [here](https://github.com/berkeley-dsep-infra/jupyterlab-a11y-checker/blob/main/doc/rules.md). + +You can access the accessibility checker on the [Accessibility DataHub](https://a11y.datahub.berkeley.edu/). Click on the following icon on the right hand side of the window. Then, click "Analyze Notebook". + +accessibility icon + +Feel free to experiment with the AI included, but note that the models aren't among the most powerful and may not be the most useful for generating alt text. + +## General Jupyter Accessibility + +Unforuntately, Jupyter software is not inherently accessible. [Check here](https://jupyter-accessibility.readthedocs.io/en/latest/) to see the status of the Jupyter project's accessibility efforts. + +## Accessibility at Berkeley + +View the [Digital Accessibility Program's webpage](https://dap.berkeley.edu/) for the most up-to-date guidance on general accessibility at Berkeley and clarity on the standards. \ No newline at end of file From e9e1be078542f5b2e0c7dd61fdea43c0a42e534b Mon Sep 17 00:00:00 2001 From: Silas Santini <70163606+pancakereport@users.noreply.github.com> Date: Thu, 11 Sep 2025 15:59:32 -0700 Subject: [PATCH 3/3] link to a11y page --- course-software/otter/releasing-assignment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/course-software/otter/releasing-assignment.md b/course-software/otter/releasing-assignment.md index a8cec03..869eba4 100644 --- a/course-software/otter/releasing-assignment.md +++ b/course-software/otter/releasing-assignment.md @@ -29,7 +29,7 @@ numpy.__version__ ## Before an assignment is released -Confirm that the source notebook (the one passed to `otter assign`) is accessible. +Confirm that the source notebook (the one passed to `otter assign`) is accessible. See [here](../../notebook-accessibility) for more guidance. **Run `otter assign` on DataHub.** We do NOT recommend to run this command locally, even if you're using a virtual environment. You can clone the development repo in DataHub via the command line/terminal.