openwebwork · drgrice1 · Oct 29, 2025 · Dec 2, 2025 · Dec 4, 2025 · Dec 4, 2025
diff --git a/.github/FUNDING.yml b/.github/FUNDING.yml
@@ -9,4 +9,4 @@ community_bridge: # Replace with a single Community Bridge project-name e.g., cl
 liberapay: # Replace with a single Liberapay username
 issuehunt: # Replace with a single IssueHunt username
 otechie: # Replace with a single Otechie username
-custom: ["https://webwork.maa.org/wiki"]
+custom: ['https://wiki.openwebwork.org/wiki']
diff --git a/.github/workflows/check-formats.yml b/.github/workflows/check-formats.yml
@@ -26,7 +26,7 @@ jobs:
         run: |
           git config --global --add safe.directory "$GITHUB_WORKSPACE"
           shopt -s extglob globstar nullglob
-          perltidy --pro=./.perltidyrc -b -bext='/' ./**/*.p[lm] ./**/*.t && git diff --exit-code
+          perltidy --pro=./.perltidyrc -b -bext='/' ./**/*.p[lm] ./**/*.t ./**/*.at && git diff --exit-code
 
   prettier:
     name: Check JavaScript, style, and HTML file formatting with prettier

diff --git a/DockerfileStage2 b/DockerfileStage2
@@ -33,7 +33,7 @@ RUN echo Cloning branch $PG_BRANCH branch from $PG_GIT_URL \
 
 # We need to change FROM before setting the ENV variables.
 
-FROM webwork-base:forWW220
+FROM webwork-base:forWW221
 
 ENV WEBWORK_URL=/webwork2 \
 	WEBWORK_ROOT_URL=http://localhost:8080 \

diff --git a/LICENSE b/LICENSE
@@ -2,7 +2,7 @@
                          Online Homework Delivery System
                                    Version 2.*
 
-                    Copyright 2000-2025, The WeBWorK Project
+                    Copyright 2000-2026, The WeBWorK Project
 
                               All rights reserved.
 
@@ -13,19 +13,19 @@
         Software Foundation; either version 2, or (at your option)
         any later version, or
 
-        b) the "Artistic License" which comes with this package.
+        b) the "Artistic License" 1.0 which comes with this package.
 
     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See either
     the GNU General Public License or the Artistic License for more details.
 
-    You should have received a copy of the Artistic License with this
-    package, in the file named "Artistic" inside the `doc` folder.  If not, we'll be glad to provide
-    one.
+    You should have received a copy of the Artistic License 1.0 with this
+    package, in the file named "Artistic" inside the `doc` folder.  If not,
+    you can find a copy at https://github.com/openwebwork/webwork2/blob/main/doc/Artistic
+    or https://perlfoundation.org/artistic-license-10.html.
 
     You should also have received a copy of the GNU General Public License
-    along with this program in the file named "Copying" inside the `doc` folder. If not, write to the
-    Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
-    02111-1307, USA or visit their web page on the internet at
-    http://www.gnu.org/copyleft/gpl.html.
+    along with this program in the file named "Copying" inside the `doc` folder.
+    If not, you can find a copy at https://github.com/openwebwork/webwork2/blob/main/doc/Copying
+    or https://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
diff --git a/README.md b/README.md
@@ -1,34 +1,35 @@
-                                       WeBWorK
-                         Online Homework Delivery System
-                                   Version 2.*
-                        Branch:  github.com/openwebwork
-
-             https://webwork.maa.org/wiki/Release_notes_for_WeBWorK_2.20
-                    Copyright 2000-2025, The WeBWorK Project
-                             https://openwebwork.org/
-                              All rights reserved.
-
 # Welcome to WeBWorK
 
-WeBWorK is an open-source online homework system for math and sciences courses. WeBWorK is supported by the MAA and the NSF and comes with an Open Problem Library (OPL) of over 30,000 homework problems. Problems in the OPL target most lower division undergraduate math courses, some advanced courses and some other STEM subjects. Supported courses include college algebra, discrete mathematics, probability and statistics, single and multivariable calculus, differential equations, linear algebra and complex analysis.  Find out more at the main WeBWorK [webpage](https://openwebwork.org).
+WeBWorK is an open-source online homework system for math and sciences courses. WeBWorK is supported by the MAA and the
+NSF and comes with an Open Problem Library (OPL) of over 30,000 homework problems. Problems in the OPL target most lower
+division undergraduate math courses, some advanced courses and some other STEM subjects. Supported courses include
+college algebra, discrete mathematics, probability and statistics, single and multivariable calculus, differential
+equations, linear algebra and complex analysis. Find out more at the main WeBWorK [webpage](https://openwebwork.org).
 
 ## Information for Users
 
-New users interested in getting started with their own WeBWorK server, or instructors looking to learn more about how to use WeBWorK in their classes, should take a look at one of the following resources:
+New users interested in getting started with their own WeBWorK server, or instructors looking to learn more about how to
+use WeBWorK in their classes, should take a look at one of the following resources:
 
-*  The [WeBWorK project home page](https://openwebwork.org/) - General information and resources including announcements of events and important project news
-*  [WeBWorK wiki](https://webwork.maa.org/wiki/Main_Page) - The main WeBWorK wiki
-*  [Installing WeBWorK](https://webwork.maa.org/wiki/Manual_Installation_Guides) - Installing WeBWorK
-*  [Instructors](https://webwork.maa.org/wiki/Instructors) - Information for Instructors
-*  [Problem Authors](https://webwork.maa.org/wiki/Authors) - Information for Problem Authors
-*  [Forum](http://webwork.maa.org/moodle/mod/forum/index.php?id=3) - The WeBWorK Forum for getting help from the community
-*  [Frequently Asked Questions](https://github.com/openwebwork/webwork2/wiki/Frequently-Asked-Questions) - A list of frequently asked questions.
+- The [WeBWorK project home page](https://openwebwork.org/) - General information and resources including announcements
+  of events and important project news
+- [WeBWorK wiki](https://wiki.openwebwork.org/wiki/Main_Page) - The main WeBWorK wiki
+- [Installing WeBWorK](https://wiki.openwebwork.org/wiki/Manual_Installation_Guides) - Installing WeBWorK
+- [Instructors](https://wiki.openwebwork.org/wiki/Instructors) - Information for Instructors
+- [Problem Authors](https://wiki.openwebwork.org/wiki/Authors) - Information for Problem Authors
+- [Forum](https://forums.openwebwork.org/mod/forum/index.php?id=3) - The WeBWorK Forum for getting help from the
+  community
+- [Frequently Asked Questions](https://github.com/openwebwork/webwork2/wiki/Frequently-Asked-Questions) - A list of
+  frequently asked questions.
 
 ## Information for Downloading
 
-* Installation manuals can be found at https://webwork.maa.org/wiki/Category:Installation_Manuals
+- See the [installation manuals](https://wiki.openwebwork.org/wiki/Category:Installation_Manuals).
 
 ## Information For Developers
 
-* People interested in developing new features for WeBWorK can start at https://webwork.maa.org/wiki/Category:Developers, or start a [discussion on GitHub](https://github.com/openwebwork/webwork2/discussions) to engage with the current developers.
-* People interested in developing new problems for WeBWorK should visit [Problem Authors](http://webwork.maa.org/wiki/Authors).
+- People interested in developing new features for WeBWorK can start at the wiki
+  [development page](https://wiki.openwebwork.org/wiki/Category:Developers), or start a
+  [discussion on GitHub](https://github.com/openwebwork/webwork2/discussions) to engage with the current developers.
+- People interested in developing new problems for WeBWorK should visit the wiki
+  [problem authoring page](https://wiki.openwebwork.org/wiki/Authors).
diff --git a/VERSION b/VERSION
@@ -1,4 +1,4 @@
-$WW_VERSION = '2.20';
-$WW_COPYRIGHT_YEARS = '1996-2025';
+$WW_VERSION = '2.21';
+$WW_COPYRIGHT_YEARS = '1996-2026';
 
 1;
diff --git a/assets/hardcopyThemes/basic.xml b/assets/hardcopyThemes/basic.xml
@@ -3,7 +3,7 @@
 
 <description>
 This theme produces hardcopies with minimal page headers displaying the set
-title and useername, and minimal problem numbering.
+title and username, and minimal problem numbering.
 </description>
 
 <preamble>

diff --git a/assets/hardcopyThemes/basicTwoCol.xml b/assets/hardcopyThemes/basicTwoCol.xml
@@ -3,7 +3,7 @@
 
 <description>
 This theme produces hardcopies with minimal page headers displaying the set
-title and useername, and minimal problem numbering. With two columns.
+title and username, and minimal problem numbering. With two columns.
 </description>
 
 <preamble>

diff --git a/assets/pg/PGMLLab/PGML-lab.pg b/assets/pg/PGMLLab/PGML-lab.pg
@@ -682,9 +682,9 @@ TEXT(tag(
 								>> At the right
 
 								>> Several lines combined.
-								>> right justfied
+								>> right justified
 
-								>> Or a whole paragaph
+								>> Or a whole paragraph
 								that is pushed to the right
 
 								>> Or two lines  

diff --git a/assets/pg/Student_Orientation/discriminant.png b/assets/pg/Student_Orientation/discriminant.png
diff --git a/assets/pg/Student_Orientation/enteringMath.pg b/assets/pg/Student_Orientation/enteringMath.pg
@@ -21,9 +21,9 @@ expression automatically is converted to look like [::pi/sqrt(x+1)::]. [_]{Conte
 
 Occasionally you will want to answer with raw text that should not be converted into a math expression. For example, if
 the answer is a word. For this kind of answer, you should enter "text mode". There is a "Tt" button on the palette  that
-enters and exits text mode. You can also use the [|"|]* character to enter text mode, and then exit with the [|tab|]*
-key or right arrow. Try answering the following with and without using text mode. The answer is [|pirate|]*:
-[_]{Context("Numeric")->strings->add(pirate => {}), 'pirate'}{16}.
+enters and exits text mode. You can also use the double quote character ([|"|]*) to enter text mode, and then exit with
+the [|tab|]* key or right arrow. Try answering the following with and without using text mode. The answer is [|web|]*:
+[_]{Context("Numeric")->strings->add(web => {}), 'web'}{16}.
 
 The palette tool might be a distraction, especially to keyboard-only users. You can disable it by right-clicking (or
 control-clicking) in an answer blank. To "right click" without a mouse:

diff --git a/assets/pg/Student_Orientation/explorerfull.png b/assets/pg/Student_Orientation/explorerfull.png
diff --git a/assets/pg/Student_Orientation/explorerpiece.png b/assets/pg/Student_Orientation/explorerpiece.png
diff --git a/assets/pg/Student_Orientation/mathInteraction.pg b/assets/pg/Student_Orientation/mathInteraction.pg
@@ -26,37 +26,54 @@ Once focus is on a math expression, using the space bar will activate the "MathJ
 by right-clicking (Windows/Linux) or [|control|]*-clicking (MacOS) a piece of math. Try activating the MathJax menu now.
 It should look like the following.
 
->> [!MathJax contextual menu!]{'mathjaxmenu.png'} <<
+>> [!MathJax contextual menu!]{'mathjaxmenu.png'}{140} <<
 
 There are many features that help you to engage with math content. Explore the menu options to survey what is available.
 
-We will now point out a few important features. In the main menu, there is a "Math Settings" submenu. The "Zoom Trigger"
-and "Zoom Factor" items allow you to control if/how math content is magnified. Magnification may help users with some
-vision disabilities see the content better. And it may help all users to see some details of math notation better. Take
-a moment to explore these settings and select options that you would be comfortable with. (Of course you can change
-these settings at any time.)
-
-Also in the main menu, there is an "Accessibility" submenu. In that menu, if accessibility is not already activated,
-select "Activate". After activating this, you may need to refresh the web page to see the math expression again. Now you
-have the option to see math content verbalized. To do this, place focus onto a math expression and hit [|enter|]*.
-* At first, the entire expression is highlighted and there will be a verbal rendering of the expression.  
-[!Speech string for the quadratic formula!]{'explorerfull.png'}{600}
-* Use the down arrow to navigate "down" into a smaller piece of the math expression.
-* Use the left/right arrows to navigate to similar pieces of the math expression.
-* At any time you can navigate back "up" to a larger part of the expression, or "down" into smaller pieces. For example,
-you can see a verbalization for just this part of the expression above:  
-[!Speech string for the radicand of the quadratic formula!]{'explorerpiece.png'}{600} 
-* Return to the MathJax menu, Accessibility submenu, to explore options for how this explorer tool works.
-* Under "Speech" you will find options to use MathSpeak, ClearSpeak, or ChromeVox rules. The default is to use
-"MathSpeak verbose" rules, which try try to read math "literally" without context. For example, it reads [`(1,3)`] as
-"left parenthesis 1 comma 3 right parenthesis". Other speech rules can produce more meaningful verbal renderings. For
-example with the right ClearSpeak settings, the same math expression produces "the point with coordinates 1 comma 3"
-or "the interval from 1 to 3 not including 1 or 3". 
+### Enlarging Math
+
+In the main menu, there is a "Math Settings" submenu. The "Zoom Trigger" and "Zoom Factor" items allow you to control
+if/how math content is magnified. Magnification may help users with some vision disabilities see the content better.
+And it may help all users to see some details of math notation better. Take a moment to explore these settings and
+select options that you would be comfortable with. (Of course you can change these settings at any time.)
+
+### Navigating Math
+
+When focus is on a piece of math content, there is a small help icon in the upper right. Click this icon to see a guide
+for how to navigate inside the math content. This can help you understand the meaning of the math content. For example,
+here we have navigated to the piece of math content inside the radical:
+
+[!Highlighting the discriminant in the quadratic formula!]{'discriminant.png'}{600}
+
+### Subtitles for Math
+
+Also in the main menu, there is an "Accessibility" submenu. Accessibility is enabled by default, but you can also select
+"Show Subtitles" in the "Speech" submenu.  This allows you to see math content verbalized. To do this, place focus onto
+a math expression and hit [|enter|]*. At first, the entire expression is highlighted and there will be a verbal
+rendering of the expression.
+[!Speech string for the quadratic formula!]{'explorerfull.png'}{735}
+
+As you navigate within the math using arrows, you can see verbalizations of the corresponding pieces:
+
+[!Speech string for the radicand of the quadratic formula!]{'explorerpiece.png'}{735}
+
+Under "Speech" you will find options for MathSpeak and ClearSpeak rules. The default is to use "MathSpeak verbose"
+rules, which try try to read math "literally" without context. For example, it reads [`(1,3)`] as "left parenthesis 1
+comma 3 right parenthesis". Other speech rules can produce more meaningful verbal renderings. For example with the right
+ClearSpeak settings, the same math expression produces "the point with coordinates 1 comma 3" or "the interval from 1 to
+3 not including 1 or 3".
+
+### Voicing Math Out Loud
+
+When focus is on math content, use the [|s|]* character to hear the math spoken. If you would like math to always be
+spoken whenever focus lands on math, check Auto Voicing in the Speech menu.
+
+### Disabling Tab Indexing
 
 Some keyboard-navigating users might find it undesirable for each piece of math content to be tab-indexed. If this is
-the case, then in the "Accessibility" sub menu you can uncheck "Include in Tab Order". Just note that in order to undo
-this and make math content tabbable again, you will need to access the menu, and so you will need some way other than
-tabbing to bring focus back to a piece of math content.
+the case, then in the "Options" submenu of the "Accessibility" submenu you can uncheck "Include in Tab Order" and
+"Semantic Enrichment". Just note that in order to undo this and make math content tabbable again, you will need to
+access the menu, and so you will need some way other than tabbing to bring focus back to a piece of math content.
 END_BODY
 
 $images = <<END_BODY;

diff --git a/assets/pg/Student_Orientation/mathjaxmenu.png b/assets/pg/Student_Orientation/mathjaxmenu.png