General and Principal Logarithm Math Content Reading the Same way in ScreenReaders (needs a way to hear the difference in caps L Log vs. lower case l log).

Open
#112 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
65/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
accessibility

Research direction

Start with Definition 5.2.2 at the linked Complex Analysis page and trace MathCAT's pronunciation handling for lowercase "log" and uppercase "Log". Done means screen readers can audibly distinguish the general logarithm from the principal logarithm, with the behavior checked using the reported example.

Written by the indexing model from the issue text.

Description

  1. go to this Complex Analysis link in the browser of your choice:
    https://complexanalysis.org/web/sec_complex-log.html
  2. Find Definition 5.2.2. Principal value of the logarithm. (Search for "principal" without quotes.) 3. Read down until you find, "The domain for the function, Log."
    Problem: Screenreaders are not differentiating between lower-case "log," and upper-case "Log." They have different meanings.

In short, and you may just have to take my word for this one, log(-1), in complex analysis, has infinite answers. Not only is e^(pi i) = -1, but e to the power of any odd number multiplied by pi i, also. Saying "log(-1)" can mean any of those. The "principal logarithm" (similar to principal square root in that
context) refers to the official one accepted form for complex analysis, which, in this case, is simply "pi i." The principal logarithm is written with the word "Log," with a capital L. JAWS renders both as "log," but students need to know the difference in order to know what to write down in assignments.
Expected: MathCAT pronunciation that screen readers can use to pronounce "Log" differently from "log."

Dominant language
Python
Stars
10
Forks
10
Avg merge
10h 40m
Merged PRs (30d)
4

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from daisy/MathCATForPython

All issues in daisy/MathCATForPython

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.