daisy / daisy/MathCATForPython

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).

オープン
#112 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
主要言語
Python
スター
10
フォーク
10
平均マージ
10時間 40分
マージ済み PR(30日)
4

説明

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."

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

評価

技術スタック
python
領域
accessibility
issue の種類
機能追加
難易度
3/5
見積もり時間
1〜2日
活発さ
活発
明瞭さ
おおむね明確
初心者へのやさしさ
65/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。