Porting several accessibility pages from GNOME help

Author: msuchane

docs/how-to/accessibility/adjust-the-contrast.md

@@ -0,0 +1,14 @@
+(adjust-the-contrast)=
+# Adjust the contrast
+
+You can adjust the contrast of windows and buttons so that they’re easier to see. This is not the same as changing the brightness of the whole screen; only parts of the user interface will change.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Seeing` section.
+4. Enable the {guilabel}`High Contrast` option.
+
+:::{tip}
+You can turn high contrast on and off by clicking the {ref}`accessibility icon <find-the-accessibility-menu>` on the top bar and selecting {guilabel}`High Contrast`.
+:::
+

docs/how-to/accessibility/change-text-size-on-the-screen.md

@@ -0,0 +1,18 @@
+(change-text-size-on-the-screen)=
+# Change text size on the screen
+
+If you have difficulty reading the text on your screen, you can change the size of the font.
+
+1. Open the Activities overview and start typing **accessibility**.
+2. Click on {guilabel}`Accessibility` to open the panel.
+3. Open the {guilabel}`Seeing` section.
+4. Enable the {guilabel}`Large Text` option.
+
+Alternatively, you can quickly change the text size by clicking the {ref}`accessibility icon <find-the-accessibility-menu>` on the top bar and selecting {guilabel}`Large Text`.
+
+Large Text scales the text by 1.2 times. You can use Tweaks to make text size bigger or smaller.
+
+:::{tip}
+In many applications, you can increase the text size at any time by pressing {kbd}`Ctrl++`. To reduce the text size, press {kbd}`Ctrl+-`.
+:::
+

docs/how-to/accessibility/find-the-accessibility-menu.md

@@ -0,0 +1,17 @@
+(find-the-accessibility-menu)=
+# Find the accessibility menu
+
+The *accessibility menu* is where you can turn on some of the accessibility settings. You can find this menu by clicking the icon which looks like a person on the top bar.
+
+![The accessibility menu can be found on the top bar.](person.png)
+
+If you do not see the accessibility menu, you can enable it from the Accessibility settings panel:
+
+1. Open the Activities overview and start typing Accessibility.
+
+2. Click on Accessibility to open the panel.
+
+3. Switch the Accessibility Menu switch to on.
+
+To access this menu using the keyboard rather than the mouse, press {kbd}`Ctrl+Alt+Tab` to move the keyboard focus to the top bar. The Activities button in the top-left corner will get highlighted — this tells you which item on the top bar is selected. Use the arrow keys on the keyboard to move the selected item to the accessibility menu icon and then press {kbd}`Enter` to open it. You can use the up and down arrow keys to select items in the menu. Press {kbd}`Enter` to toggle the selected item.
+

docs/how-to/accessibility/index.md

@@ -0,0 +1,14 @@
+# Accessibility
+
+The system includes assistive technologies to support users with various impairments and special needs, and to interact with common assistive devices. An accessibility menu can be added to the top bar, giving easier access to many of the accessibility features.
+
+:::{toctree}
+:maxdepth: 2
+
+find-the-accessibility-menu
+read-screen-aloud
+read-screen-in-braille
+adjust-the-contrast
+change-text-size-on-the-screen
+:::
+

docs/how-to/accessibility/read-screen-aloud.md

@@ -0,0 +1,25 @@
+(read-screen-aloud)=
+# Read screen aloud
+
+The Orca screen reader can speak the user interface. Depending on how you installed your system, you might not have Orca installed. If not, install Orca first.
+
+```bash
+sudo apt install orca
+```
+
+To start Orca using the keyboard, press {kbd}`Super+Alt+S`.
+
+Or to start Orca using a mouse and keyboard:
+
+1. Open the Activities overview and start typing **accessibility**.
+
+2. Click {guilabel}`Accessibility` to open the panel.
+
+3. Select the {guilabel}`Seeing` section to open it.
+
+4. Enable the {guilabel}`Screen Reader` switch.
+
+:::{tip}
+You can turn Screen Reader on and off by clicking the {ref}`accessibility icon <find-the-accessibility-menu>` in the top bar and selecting {guilabel}`Screen Reader`.
+:::
+

docs/how-to/accessibility/read-screen-in-braille.md

@@ -0,0 +1,7 @@
+(read-screen-in-braille)=
+# Read screen in Braille
+
+The Orca screen reader can display the user interface on a refreshable Braille display. Depending on how you installed your system, you might not have Orca installed. If not, install Orca first.
+
+Refer to the Orca Help for more information.
+

docs/how-to/index.md

@@ -7,6 +7,6 @@ maintaining, and contributing to the starter pack.
 :maxdepth: 1
 
 log-in-using-a-smart-card
-
 enable-smart-cards-in-snapped-browsers
+accessibility/index
 :::