diff --git a/docs/accessibility/android.md b/docs/accessibility/browser/android.md similarity index 100% rename from docs/accessibility/android.md rename to docs/accessibility/browser/android.md diff --git a/docs/accessibility/figures/Makefile b/docs/accessibility/browser/figures/Makefile similarity index 100% rename from docs/accessibility/figures/Makefile rename to docs/accessibility/browser/figures/Makefile diff --git a/docs/accessibility/figures/ax_tree.gv b/docs/accessibility/browser/figures/ax_tree.gv similarity index 100% rename from docs/accessibility/figures/ax_tree.gv rename to docs/accessibility/browser/figures/ax_tree.gv diff --git a/docs/accessibility/figures/ax_tree.png b/docs/accessibility/browser/figures/ax_tree.png similarity index 100% rename from docs/accessibility/figures/ax_tree.png rename to docs/accessibility/browser/figures/ax_tree.png diff --git a/docs/accessibility/figures/caching_approach.gv b/docs/accessibility/browser/figures/caching_approach.gv similarity index 100% rename from docs/accessibility/figures/caching_approach.gv rename to docs/accessibility/browser/figures/caching_approach.gv diff --git a/docs/accessibility/figures/caching_approach.png b/docs/accessibility/browser/figures/caching_approach.png similarity index 100% rename from docs/accessibility/figures/caching_approach.png rename to docs/accessibility/browser/figures/caching_approach.png diff --git a/docs/accessibility/figures/cover_flow.gv b/docs/accessibility/browser/figures/cover_flow.gv similarity index 100% rename from docs/accessibility/figures/cover_flow.gv rename to docs/accessibility/browser/figures/cover_flow.gv diff --git a/docs/accessibility/figures/cover_flow.png b/docs/accessibility/browser/figures/cover_flow.png similarity index 100% rename from docs/accessibility/figures/cover_flow.png rename to docs/accessibility/browser/figures/cover_flow.png diff --git a/docs/accessibility/figures/focus_race.gv b/docs/accessibility/browser/figures/focus_race.gv similarity index 100% rename from docs/accessibility/figures/focus_race.gv rename to docs/accessibility/browser/figures/focus_race.gv diff --git a/docs/accessibility/figures/focus_race.png b/docs/accessibility/browser/figures/focus_race.png similarity index 100% rename from docs/accessibility/figures/focus_race.png rename to docs/accessibility/browser/figures/focus_race.png diff --git a/docs/accessibility/figures/generated_content.gv b/docs/accessibility/browser/figures/generated_content.gv similarity index 100% rename from docs/accessibility/figures/generated_content.gv rename to docs/accessibility/browser/figures/generated_content.gv diff --git a/docs/accessibility/figures/generated_content.png b/docs/accessibility/browser/figures/generated_content.png similarity index 100% rename from docs/accessibility/figures/generated_content.png rename to docs/accessibility/browser/figures/generated_content.png diff --git a/docs/accessibility/figures/hidden_content.gv b/docs/accessibility/browser/figures/hidden_content.gv similarity index 100% rename from docs/accessibility/figures/hidden_content.gv rename to docs/accessibility/browser/figures/hidden_content.gv diff --git a/docs/accessibility/figures/hidden_content.png b/docs/accessibility/browser/figures/hidden_content.png similarity index 100% rename from docs/accessibility/figures/hidden_content.png rename to docs/accessibility/browser/figures/hidden_content.png diff --git a/docs/accessibility/figures/multi_process_ax.gv b/docs/accessibility/browser/figures/multi_process_ax.gv similarity index 100% rename from docs/accessibility/figures/multi_process_ax.gv rename to docs/accessibility/browser/figures/multi_process_ax.gv diff --git a/docs/accessibility/figures/multi_process_ax.png b/docs/accessibility/browser/figures/multi_process_ax.png similarity index 100% rename from docs/accessibility/figures/multi_process_ax.png rename to docs/accessibility/browser/figures/multi_process_ax.png diff --git a/docs/accessibility/figures/multi_process_browser.gv b/docs/accessibility/browser/figures/multi_process_browser.gv similarity index 100% rename from docs/accessibility/figures/multi_process_browser.gv rename to docs/accessibility/browser/figures/multi_process_browser.gv diff --git a/docs/accessibility/figures/multi_process_browser.png b/docs/accessibility/browser/figures/multi_process_browser.png similarity index 100% rename from docs/accessibility/figures/multi_process_browser.png rename to docs/accessibility/browser/figures/multi_process_browser.png diff --git a/docs/accessibility/figures/multi_process_multiple_tabs.gv b/docs/accessibility/browser/figures/multi_process_multiple_tabs.gv similarity index 100% rename from docs/accessibility/figures/multi_process_multiple_tabs.gv rename to docs/accessibility/browser/figures/multi_process_multiple_tabs.gv diff --git a/docs/accessibility/figures/multi_process_multiple_tabs.png b/docs/accessibility/browser/figures/multi_process_multiple_tabs.png similarity index 100% rename from docs/accessibility/figures/multi_process_multiple_tabs.png rename to docs/accessibility/browser/figures/multi_process_multiple_tabs.png diff --git a/docs/accessibility/figures/other_multi_process_browser.gv b/docs/accessibility/browser/figures/other_multi_process_browser.gv similarity index 100% rename from docs/accessibility/figures/other_multi_process_browser.gv rename to docs/accessibility/browser/figures/other_multi_process_browser.gv diff --git a/docs/accessibility/figures/other_multi_process_browser.png b/docs/accessibility/browser/figures/other_multi_process_browser.png similarity index 100% rename from docs/accessibility/figures/other_multi_process_browser.png rename to docs/accessibility/browser/figures/other_multi_process_browser.png diff --git a/docs/accessibility/figures/proxy_approach.gv b/docs/accessibility/browser/figures/proxy_approach.gv similarity index 100% rename from docs/accessibility/figures/proxy_approach.gv rename to docs/accessibility/browser/figures/proxy_approach.gv diff --git a/docs/accessibility/figures/proxy_approach.png b/docs/accessibility/browser/figures/proxy_approach.png similarity index 100% rename from docs/accessibility/figures/proxy_approach.png rename to docs/accessibility/browser/figures/proxy_approach.png diff --git a/docs/accessibility/figures/single_process.gv b/docs/accessibility/browser/figures/single_process.gv similarity index 100% rename from docs/accessibility/figures/single_process.gv rename to docs/accessibility/browser/figures/single_process.gv diff --git a/docs/accessibility/figures/single_process.png b/docs/accessibility/browser/figures/single_process.png similarity index 100% rename from docs/accessibility/figures/single_process.png rename to docs/accessibility/browser/figures/single_process.png diff --git a/docs/accessibility/figures/single_process_css_system.gv b/docs/accessibility/browser/figures/single_process_css_system.gv similarity index 100% rename from docs/accessibility/figures/single_process_css_system.gv rename to docs/accessibility/browser/figures/single_process_css_system.gv diff --git a/docs/accessibility/figures/single_process_css_system.png b/docs/accessibility/browser/figures/single_process_css_system.png similarity index 100% rename from docs/accessibility/figures/single_process_css_system.png rename to docs/accessibility/browser/figures/single_process_css_system.png diff --git a/docs/accessibility/figures/single_process_system.gv b/docs/accessibility/browser/figures/single_process_system.gv similarity index 100% rename from docs/accessibility/figures/single_process_system.gv rename to docs/accessibility/browser/figures/single_process_system.gv diff --git a/docs/accessibility/figures/single_process_system.png b/docs/accessibility/browser/figures/single_process_system.png similarity index 100% rename from docs/accessibility/figures/single_process_system.png rename to docs/accessibility/browser/figures/single_process_system.png diff --git a/docs/accessibility/how_a11y_works.md b/docs/accessibility/browser/how_a11y_works.md similarity index 98% rename from docs/accessibility/how_a11y_works.md rename to docs/accessibility/browser/how_a11y_works.md index 70ee7ec424c829..294535b0037c29 100644 --- a/docs/accessibility/how_a11y_works.md +++ b/docs/accessibility/browser/how_a11y_works.md @@ -4,13 +4,13 @@ This document explains the technical details behind Chrome accessibility code by starting at a high level and progressively adding more levels of detail. -Please read the accessibility [overview](overview.md) first. +Please read the accessibility [overview](../overview.md) first. [TOC] ## Accessibility for a simple (non-browser) application -As described in the [overview](overview.md), every platform has its own +As described in the [overview](../overview.md), every platform has its own accessibility APIs that are used by both assistive technology and sometimes by automation software. To better understand the challenges of accessibility support in Chromium, let's first explore what it's like to build an diff --git a/docs/accessibility/how_a11y_works_2.md b/docs/accessibility/browser/how_a11y_works_2.md similarity index 100% rename from docs/accessibility/how_a11y_works_2.md rename to docs/accessibility/browser/how_a11y_works_2.md diff --git a/docs/accessibility/how_a11y_works_3.md b/docs/accessibility/browser/how_a11y_works_3.md similarity index 100% rename from docs/accessibility/how_a11y_works_3.md rename to docs/accessibility/browser/how_a11y_works_3.md diff --git a/docs/accessibility/ia2_to_uia.md b/docs/accessibility/browser/ia2_to_uia.md similarity index 100% rename from docs/accessibility/ia2_to_uia.md rename to docs/accessibility/browser/ia2_to_uia.md diff --git a/docs/accessibility/images/cover_flow.jpg b/docs/accessibility/browser/images/cover_flow.jpg similarity index 100% rename from docs/accessibility/images/cover_flow.jpg rename to docs/accessibility/browser/images/cover_flow.jpg diff --git a/docs/accessibility/offscreen.md b/docs/accessibility/browser/offscreen.md similarity index 100% rename from docs/accessibility/offscreen.md rename to docs/accessibility/browser/offscreen.md diff --git a/docs/accessibility/perf.md b/docs/accessibility/browser/perf.md similarity index 100% rename from docs/accessibility/perf.md rename to docs/accessibility/browser/perf.md diff --git a/docs/accessibility/reader_mode.md b/docs/accessibility/browser/reader_mode.md similarity index 100% rename from docs/accessibility/reader_mode.md rename to docs/accessibility/browser/reader_mode.md diff --git a/docs/accessibility/tests.md b/docs/accessibility/browser/tests.md similarity index 100% rename from docs/accessibility/tests.md rename to docs/accessibility/browser/tests.md diff --git a/docs/accessibility/tts.md b/docs/accessibility/browser/tts.md similarity index 97% rename from docs/accessibility/tts.md rename to docs/accessibility/browser/tts.md index 3cbe949e4502b8..36e58b4bf68879 100644 --- a/docs/accessibility/tts.md +++ b/docs/accessibility/browser/tts.md @@ -56,7 +56,7 @@ platform. forwards speech events to PATTS, or the network speech engine, or, coming soon, third-party speech engines. - - [PATTS](patts.md) is the built-in Chrome OS text-to-speech engine. + - [PATTS](../os/patts.md) is the built-in Chrome OS text-to-speech engine. ### Testing diff --git a/docs/accessibility/uiautomation.md b/docs/accessibility/browser/uiautomation.md similarity index 100% rename from docs/accessibility/uiautomation.md rename to docs/accessibility/browser/uiautomation.md diff --git a/docs/accessibility/autoclick.md b/docs/accessibility/os/autoclick.md similarity index 100% rename from docs/accessibility/autoclick.md rename to docs/accessibility/os/autoclick.md diff --git a/docs/accessibility/brltty.md b/docs/accessibility/os/brltty.md similarity index 100% rename from docs/accessibility/brltty.md rename to docs/accessibility/os/brltty.md diff --git a/docs/accessibility/chromevox.md b/docs/accessibility/os/chromevox.md similarity index 100% rename from docs/accessibility/chromevox.md rename to docs/accessibility/os/chromevox.md diff --git a/docs/accessibility/chromevox_on_desktop_linux.md b/docs/accessibility/os/chromevox_on_desktop_linux.md similarity index 100% rename from docs/accessibility/chromevox_on_desktop_linux.md rename to docs/accessibility/os/chromevox_on_desktop_linux.md diff --git a/docs/accessibility/espeak.md b/docs/accessibility/os/espeak.md similarity index 98% rename from docs/accessibility/espeak.md rename to docs/accessibility/os/espeak.md index e09e0618a6312d..a121ccbe32cdce 100644 --- a/docs/accessibility/espeak.md +++ b/docs/accessibility/os/espeak.md @@ -4,7 +4,7 @@ Chrome OS comes with a port of the open-source eSpeak-NG speech synthesis engine. eSpeak-NG is lower quality than Google's "PATTS" speech engine, but it's faster, uses less resources, and supports more languages. -[Read more about Text-to-Speech in Chrome](tts.md). +[Read more about Text-to-Speech in Chrome](../browser/tts.md). [See also Google's "PATTS" speech engine](patts.md). diff --git a/docs/accessibility/patts.md b/docs/accessibility/os/patts.md similarity index 98% rename from docs/accessibility/patts.md rename to docs/accessibility/os/patts.md index 719d97c238a8fe..0165106c82a778 100644 --- a/docs/accessibility/patts.md +++ b/docs/accessibility/os/patts.md @@ -3,7 +3,7 @@ Chrome OS comes with a speech synthesis engine developed internally at Google called PATTS. It's based on the same engine that ships with all Android devices. -[Read more about Text-to-Speech in Chrome](tts.md). +[Read more about Text-to-Speech in Chrome](../browser/tts.md). [See also the eSpeak engine](espeak.md). diff --git a/docs/accessibility/select_to_speak.md b/docs/accessibility/os/select_to_speak.md similarity index 100% rename from docs/accessibility/select_to_speak.md rename to docs/accessibility/os/select_to_speak.md diff --git a/docs/accessibility/switch_access.md b/docs/accessibility/os/switch_access.md similarity index 100% rename from docs/accessibility/switch_access.md rename to docs/accessibility/os/switch_access.md diff --git a/docs/accessibility/overview.md b/docs/accessibility/overview.md index 72c95f9aa850eb..261980013627c2 100644 --- a/docs/accessibility/overview.md +++ b/docs/accessibility/overview.md @@ -218,11 +218,11 @@ Automation Inspector Chrome extension). ### Supported Platforms and APIs * Windows: IAccessible (also known as Microsoft Active Accessibility or MSAA), - IAccessible2, [UI Automation](uiautomation.md). Chromium also supports - [mapping between IAccessible2 and UI Automation nodes](ia2_to_uia.md). + IAccessible2, [UI Automation](browser/uiautomation.md). Chromium also supports + [mapping between IAccessible2 and UI Automation nodes](browser/ia2_to_uia.md). * Mac: NSAccessibility * Linux: ATK -* Android: [AccessibilityNodeInfo and AccessibilityNodeProvider](android.md) +* Android: [AccessibilityNodeInfo and AccessibilityNodeProvider](browser/android.md) ## Chromium's multi-process architecture @@ -520,7 +520,9 @@ is defined by [automation.idl], which must be kept synchronized with ## Further reading -For more detail, read [How Chrome Accessibility Works](how_a11y_works.md). +For more detail on Chrome web contents and platform accessibility, read [How Chrome Accessibility Works](browser/how_a11y_works.md). + +# TODO(accessibility): write os equiavlent how does Chrome os a11y work. [ax.mojom.AXActionData]: https://source.chromium.org/chromium/chromium/src/+/main:ui/accessibility/mojom/ax_action_data.mojom;l=13 [ax.mojom.RenderAccessibilityHost::HandleAXEvents()]: https://source.chromium.org/chromium/chromium/src/+/main:content/common/render_accessibility.mojom;l=47