daisy / daisy/math-a11y

Is using a text editor a workflow for creating linear math for Word?

Open
#19 3 comments 0 reactions 0 assignees View on GitHub
severity:medium verified
Dominant language
VBA
Stars
7
Forks
4
PR merge metrics
No merged PRs in 30d

Description

It is very easy to create linear expressions in a text editor. It currently seems that a screen reader user gets tripped up in the Microsoft Word math editor. If you make a mistake and backspace or if you add a space accidendetly, it becomes difficult to make changes.

Testing with Notepad, Notepad++, and VS Code, the three editors behaved the same.

Taking the expression, \sqrt ((4^3 +2)/2a) =7 and pasting it into the Word math editor, i.e., alt+= and then ctrl+v and then pressing enter produced the correct results. Moving back into the expression in Word and pressing ctrl+= built up the expression.

Then going from Word to the texteditors also worked identically. Copying the linear expression or the built-up expressionn to the clipboard and pasting it into the editors gave us:

√((4^3+2)/2a)=7

Notice that \sqrt was converted to the unicode character.

Now going back into Word and pasting the expression using √ instead of \sqrt yielded the same results. The only difference is that with \sqrt, you need to have a space character after the shortcut whereas with √, you should not put in a space.

It seems that students and professionals could benefit from using this workflow to create documents with math. If a textbook in HTML or EPUB with MathML were provided to the students, the mathML can be copied into the Word document and converted to the Office Math from Word.

The math that originated as MathML can then be copied and pasted as text and then edited and pasted back into Word.

If we think this is a good option, we should create documentation describing the workflow.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the Word, Notepad, Notepad++, and VS Code copy-paste examples described in the issue. Document the tested workflow, including Word's Alt+= and Ctrl+= steps, the differences between \sqrt and √, and copying MathML into Word; done means a newcomer can follow the workflow without relying on the issue thread.

Written by the indexing model from the issue text.

Assessment

Tech stack
vscode
Domain
accessibility, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.