Improve list of Math AutoCorrect Codes found on the "Linear format equations using UnicodeMath and LaTeX in Word" support page
- Dominant language
- VBA
- Stars
- 7
- Forks
- 4
- PR merge metrics
- No merged PRs in 30d
Description
# Description
The [Linear format equations using UnicodeMath and LaTeX in Word](https://support.microsoft.com/en-us/office/linear-format-equations-using-unicodemath-and-latex-in-word-2e00618d-b1fd-49d8-8cb4-8d17f25754f8) support.microsoft.com page includes a lengthy (250+ row table) of Math AutoCorrect codes and Math AutoReplace shortcuts.
Knowledge of the Math AutoCorrect codes is essential for anyone using the keyboard to enter mathematical expressions into the Equation Editor in Word. In the table's current form, these codes can be challenging to find and use effectively. The current table is not fully accessible nor is it optimally organized for learning and reference:
- The table is difficult to find as it is only found when an accordion/expanding heading with the name of "Automatically convert expressions to professional format" is expanded and lacks a descriptive heading that would indicate its presence.
- The symbols in the "To get" column are presented as images and all of them have the same alt-text of "Mathematical symbol".
- The Math AutoCorrect codes in the "Type" column are simply listed in alphabetical order. They do not explain their purpose; not all Math AutoCorrect codes are intuitively named (e.g.: \cup for the set union symbol). Nor do they provide an example of how they can be used.
# Expected Behavior
- The Math AutoCorrect codes listing should organize the Math AutoCorrect entries by purpose (mathematical category) to make finding a desired code easier.
- The table should provide a purpose oriented description of the Math AutoCorrect code.
- The table should provide a description of the resulting symbol if applicable.
- The table should provide an example of using the Math AutoCorrect code in a UnicodeMath expression.
- The table should provide an accessible representation of the example's output.
# Recommendation
We have created a sample HTML page that demonstrates how the above expected behavior could be achieved: [List of Commonly Used Math AutoCorrect Entries in Word 365](https://daisy.github.io/math-a11y/docs/ms-math/List-of-Commonly-Used-Math-AutoCorrect-Entries-in-Word-365.html)
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with the linked sample HTML page, List of Commonly Used Math AutoCorrect Entries in Word 365, and compare it with the Microsoft support page's expanded Math AutoCorrect table. Organize the entries by mathematical purpose and add descriptions, UnicodeMath examples, resulting-symbol explanations, and accessible output representations as specified. Done means the listing is easier to find, navigate, understand, and use with assistive technology.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html, latex
- Domain
- accessibility, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100