Merge pull request #274 from freee/develop

RELEASE Ver. 202411.0 on 2024-11-22

Author: ma10

data/yaml/faq/p0001.yaml

@@ -1,6 +1,6 @@
 id: p0001
 sortKey: 70000
-updated: '2023-12-05'
+updated: '2024-11-21'
 tags:
 - screen-reader
 title:
@@ -15,6 +15,7 @@ problem:
     *  「寡婦」が「かふ」ではなく「やもめふ」と読み上げられる
     *  「配偶者」が「はいぐうしゃ」ではなく「はいたましゃ」と読み上げられる
     *  「折り畳む」が「おりたたむ」ではなく「おりりたたみむ」と読み上げられる
+    *  「作業を行った」が「さぎょうをおこなった」ではなく「さぎょうをいった」と読み上げられる
   en: |-
     There are kanji or English words that are read in an unexpected way. How should I deal with it?
 
@@ -23,6 +24,7 @@ problem:
     *  "寡婦" is read as "やもめふ" instead of "かふ"
     *  "配偶者" is read as "はいたましゃ" instead of "はいぐうしゃ"
     *  "折り畳む" is read as "おりりたたみむ" instead of "おりたたむ"
+    *  "作業を行った" is read as "さぎょうをいった" instead of "さぎょうをおこなった"
 solution:
   ja: |-
     *  特に対処の必要はない

data/yaml/faq/p0006.yaml

@@ -1,5 +1,5 @@
 id: p0006
-sortKey: 70010
+sortKey: 70020
 updated: '2024-05-07'
 tags:
 - screen-reader

data/yaml/faq/p0007.yaml

@@ -0,0 +1,29 @@
+id: p0007
+sortKey: 70010
+updated: '2024-11-21'
+tags:
+- screen-reader
+title:
+  ja: 「2024-11-21 12:30」のような表記はスクリーン・リーダーでどう読み上げられるべきか
+  en: How Should Notations Like "2024-11-21 12:30" Be Read Aloud by Screen Readers?
+problem:
+  ja: |-
+    「2024-11-21」と表記されている日付をスクリーン・リーダーに読み上げさせたさい、「2024年11月22日」ではなく、「2024マイナス11マイナス21」と読み上げられが、このような読み上げでは理解が難しいかもしれないので、「2024年11月21日」と表記すべきか。
+    同様に時刻についても、「12:30」のような表記を「12時30分」と読み上げるようにすべきか。
+  en: |-
+    When a date is written as "2024-11-21" screen reader pronounces it as "2024 dash 11 dash 21" instead of "November 21, 2024". I'm concerned that this reading may be difficult to understand, so should it be written as "November 21, 2024"? Similarly, should the time be written as "12:30" as "12 30 PM"?
+solution:
+  ja: |-
+    広く一般に用いられている表記であれば、対処は不要
+  en: |-
+    If the notation is widely used, no further action is required.
+explanation:
+  ja: |-
+    「2024-11-21」や「12:30」のように、広く一般に用いられている日時の表記は、スクリーン・リーダーのユーザーにとってもなじみのあるもので、特に理解が難しいものではありません。
+    ですから、スクリーン・リーダーの読み上げを変更する目的で表記を変更したり、表記とは異なる非表示のテキストを指定したりする必要はありません。
+  en: |-
+    Notations such as "2024-11-21" and "12:30" are widely used and familiar also to screen reader users, so they are not particularly difficult to understand.
+    Therefore, there is no need to change the notation or specify hidden text that is different from the notation to change the screen reader's reading.
+faqs:
+- p0001
+- p0006

en/source/explanations/dynamic_content-auto-updated.rst

@@ -1,20 +1,26 @@
 .. _exp-dynamic-content-auto-updated:
 
-##################################
-自動的に変化するコンテンツの問題点
-##################################
+##########################################
+Issues with Content Changing Automatically
+##########################################
 
-自動更新される情報を含めて、動きがあったり点滅したり自動スクロールしたりするようなコンテンツが他のコンテンツと同時に同じページに存在すると、認知障害や注意障害があるユーザーの中には情報を読み取ることが困難になるユーザーがいます。
-そもそもこのような動的な変化が自動的に発生せず、短時間しか継続しなければ、この問題は発生しませんが、そうでない場合にはその動的変化をユーザーが制御できるようにすることを求めています。
+Some users with cognitive or attention disabilities may find it difficult to understand information when the following types of content are displayed on the same page along with other content:
 
-さらにより厳しい基準では、緊急の場合を除いて、プッシュ通知などによる割り込みをしないことを求めています。
-一般に割り込みが発生すると、認知障害や注意障害があるユーザーの集中を削ぐだけでなく、スクリーン・リーダーを利用している場合に情報の読み上げが中断され、混乱を生じる場合があります。
-そういった混乱を生じないために、WCAGでは健康、財産、安全を守るために必要な場合を、割り込みを発生させても良い場合として限定しています。
+*  Automatically updated
+*  Moving
+*  Flashing
+*  Auto-scrolling
 
-ページの中のある程度の面積において、輝度が特定の頻度で交互に変化する（閃光が発生する）と、一部のユーザーの光過敏性発作を誘発する可能性があります。
-WCAGでは、レベルAの達成基準でより限定的な条件を示していて、「1秒間に3回以内」という条件はレベルAAAの達成基準で挙げられています。
-しかし、レベルAの限定的な条件を正確に満たすことや、満たしていることを確認することが難しい場合もあり得ますし、ユーザーの安全に関わることですから、freeeではより厳しい条件を示しているレベルAAAの達成基準を採用しています。
+If these dynamic changes do not occur automatically or only last for a short period, such content is generally not problematic. However, in cases where they persist, WCAG requires that users be able to control these dynamic changes.
 
-参考： この達成基準はいわゆる `ポケモンショック <https://ja.wikipedia.org/wiki/%E3%83%9D%E3%82%B1%E3%83%A2%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%82%AF>`__ を受けて追加されたものです。
+Furthermore, stricter WCAG success criterion prohibits interruptions, such as push notifications, except in emergencies. Interruptions can not only break the concentration of users with cognitive or attention disabilities, but can also disrupt screen reader users, causing confusion by interrupting the reading of information. To avoid such confusion, WCAG allows interruptions only when it is needed for protecting health, property, or safety.
+
+If brightness alternates at a specific frequency (causing a flashing effect) within a certain area of the page, it may trigger photosensitive seizures in some users.
+WCAG’s Level A success criterion allows flashing under certain conditions.
+On the other hand, the Level AAA success criterion sets a stricter condition, allowing no more than 3 flashes per second in any situation.
+However, it may be difficult to precisely meet or verify compliance with the limited conditions of Level A.
+Since this is a matter of user safety, freee has adopted the stricter Level AAA success criterion.
+
+Reference: This success criterion was added in response to the so-called `Pokémon Shock <https://en.wikipedia.org/wiki/Denn%C5%8D_Senshi_Porygon>`__ incident.
 
 .. include:: /inc/info2gl/exp-dynamic-content-auto-updated.rst

en/source/intro/history.rst

@@ -12,10 +12,20 @@ For the changes to the original Japanese version, please refer to the `Japanese
    Changes After the Latest release
    ================================
 
+
+`Ver. 202411.0 (Nov 22, 2024) <https://github.com/freee/a11y-guidelines/releases/202411.0>`__
+=============================================================================================
+
+*  Added translation of :ref:`exp-dynamic-content-auto-updated`
+*  Updated FAQ
+
+   -  Added example: :ref:`faq-p0001`
+   -  Added: :ref:`faq-p0007`
+
 `Ver. 202409.0 (Sep 26, 2024) <https://github.com/freee/a11y-guidelines/releases/202409.0>`__
 =============================================================================================
 
-*  Added a new guideline  for mobile applications corresponding to WCAG 2.1 Success Criterion 2.5.1 and related explanations:
+*  Added a new guideline for mobile applications corresponding to WCAG 2.1 Success Criterion 2.5.1 and related explanations:
 
    -  Input Device: :ref:`gl-input-device-mobile-standard-gestures`
    -  :ref:`exp-mobile-a11y-basics`

ja/source/explanations/dynamic_content-auto-updated.rst

@@ -4,17 +4,28 @@
 自動的に変化するコンテンツの問題点
 ##################################
 
-自動更新される情報を含めて、動きがあったり点滅したり自動スクロールしたりするようなコンテンツが他のコンテンツと同時に同じページに存在すると、認知障害や注意障害があるユーザーの中には情報を読み取ることが困難になるユーザーがいます。
-そもそもこのような動的な変化が自動的に発生せず、短時間しか継続しなければ、この問題は発生しませんが、そうでない場合にはその動的変化をユーザーが制御できるようにすることを求めています。
+認知障害や注意障害があるユーザーの中には、以下のようなコンテンツが他のコンテンツと一緒に同じページに表示されていると、情報を理解することが難しくなるユーザーがいます。
 
-さらにより厳しい基準では、緊急の場合を除いて、プッシュ通知などによる割り込みをしないことを求めています。
+*  自動更新される
+*  動きがある
+*  点滅する
+*  自動スクロールする
+
+そもそもこのような動的な変化が自動的に発生しない、または発生しても短時間しか継続しなければ、このようなコンテンツが問題になることはありません。
+そうでない場合について、WCAGではその動的変化をユーザーが制御できるようにすることを求めています。
+
+さらに、WCAGのより厳しい基準では、緊急の場合を除いて、プッシュ通知などによる割り込みをしないことが求められています。
 一般に割り込みが発生すると、認知障害や注意障害があるユーザーの集中を削ぐだけでなく、スクリーン・リーダーを利用している場合に情報の読み上げが中断され、混乱を生じる場合があります。
 そういった混乱を生じないために、WCAGでは健康、財産、安全を守るために必要な場合を、割り込みを発生させても良い場合として限定しています。
 
 ページの中のある程度の面積において、輝度が特定の頻度で交互に変化する（閃光が発生する）と、一部のユーザーの光過敏性発作を誘発する可能性があります。
-WCAGでは、レベルAの達成基準でより限定的な条件を示していて、「1秒間に3回以内」という条件はレベルAAAの達成基準で挙げられています。
+WCAGでは、レベルAの達成基準で一定の条件下での閃光の発生を許容しています。
+一方レベルAAAの達成基準として、どのような場合も閃光は1秒間に3階以内という条件を示しています。
 しかし、レベルAの限定的な条件を正確に満たすことや、満たしていることを確認することが難しい場合もあり得ますし、ユーザーの安全に関わることですから、freeeではより厳しい条件を示しているレベルAAAの達成基準を採用しています。
 
 参考： この達成基準はいわゆる `ポケモンショック <https://ja.wikipedia.org/wiki/%E3%83%9D%E3%82%B1%E3%83%A2%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%82%AF>`__ を受けて追加されたものです。
 
 .. include:: /inc/info2gl/exp-dynamic-content-auto-updated.rst
+
+.. translated:: true
+

ja/source/explanations/screen-reader-check-nvda.rst

@@ -326,11 +326,15 @@ JAWSでは、「仮想PCカーソル」がブラウズ・モード、「フォ
 参考： NVDAチートシート
 -----------------------
 
-ここまでで紹介したキー操作などはごく一部のものですが、NVDA日本語チームが公開している `NVDAチートシート <https://github.com/nvdajp/cheatsheet>`__ には、他のキー操作も含めてまとめられています。
-GitHubのリポジトリーでは、 `Markdown版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.md>`__ 、 `pptx版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pptx>`__ 、 `PDF版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pdf>`__ と `PNG版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.png>`__ が公開されています。以下にPNG版を転載します。
+ここまでで紹介したキー操作などはごく一部のものですが、NVDA日本語チームが公開している `NVDAチートシート <https://github.com/nvdajp/cheatsheet>`__ には、キーボード配列の設定が「デスクトップ」と「ラップトップ」の場合に分けて、他のキー操作も含めてまとめられています。
+GitHubのリポジトリーでは、 `Markdown版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.md>`__ 、 `pptx版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pptx>`__ 、 `PDF版 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat.pdf>`__ とPNG版（ `デスクトップ配列 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat-desktop.png>`__ 、 `ラップトップ配列 <https://github.com/nvdajp/cheatsheet/blob/master/nvdacheat-laptop.png>`__ ）が公開されています。
+以下にデスクトップ配列のNVDAチートシートのPNG版を転載します。
 
-.. image:: /img/nvda/nvdacheat.png
-   :alt: 画像化したNVDAチートシート
+なお、前述の通り、ラップトップ配列はテンキーがない場合に便利な設定ですが、通常のチェック作業において、テンキーに割り当てられた機能を使う必要はありません。
+これらの機能を使わないと内容を確認できないようなWebページは、アクセシビリティーに関する問題がある可能性があります。
+
+.. image:: /img/nvda/nvdacheat-desktop.png
+   :alt: 画像化したデスクトップ配列のNVDAチートシート
 
 NVDAの更新
 ==========

ja/source/img/nvda/nvdacheat-desktop.png

@@ -0,0 +1,12 @@
+.. _ver-202411-0:
+
+***********************************************************************************************
+`Ver. 202411.0 (2024年11月22日) <https://github.com/freee/a11y-guidelines/releases/202411.0>`__
+***********************************************************************************************
+
+*  :ref:`exp-dynamic-content-auto-updated` の文言の見直し
+*  :ref:`exp-screen-reader-check-nvda` のNVDAチートシートを最新版に更新
+*  FAQの更新
+
+   -  例を追加： :ref:`faq-p0001`
+   -  追加： :ref:`faq-p0007`