PR#469: Accessibility docs - fedora-docs/quick-docs

		`@@ -0,0 +1,62 @@`
		`+ = Getting Started After Installing with Orca`
		`+`
		`+ Now that the system is installed, you'll need to log in with your user account`
		`+ password. But, Orca isn't speaking at this point. To turn it on, press Alt +`
		`+ Windows + S. The Windows key, from now on, will be called the Super key. This`
		`+ keyboard command is the usual command for turning on Orca. Orca will say "screen`
		`+ reader on." Now, enter your password, and press Enter.`
		`+`
		`+ Nothing will happen, but you've been logged in. To start Orca here, you'll need`
		`+ to press Alt + F2, type in "orca" all lowercase, and press Enter. You'll hear`
		`+ "screen reader on" again. Now, you won't have to turn on Orca again during`
		`+ logging in, and we'll set Orca to turn up automatically after log in as well.`
		`+`
		`+ Now, Mate has an applications menu, which lists all applications in a menu,`
ankursinha commented 2 years ago We may need to break this down into individual sections based on desktop environment. I think Alt F1 in gnome doesn't do the same thing, for example. ("Super" will get one to the applications menu. )
		`+ sorted into categories. To get to it, press Alt + F1. Now, arrow to the left to`
		`+ the System menu. Then, arrow down to Preferences, and then right arrow. Now,`
		`+ arrow down to Personal, right arrow, then arrow down to Assistive Technologies,`
		`+ and press Enter.`
		`+`
		`+ Here, we can set preferred technologies, and turn on and off Assistive`
		`+ Technologies support. First, let's turn on Assistive Technologies. Press Tab,`
		`+ and check the box. Now, Shift+Tab back to the preferred applications button, and`
		`+ press that. In this dialog, tab to the Orca combo box, and one more time to the`
		`+ Turn on at Startup check box, and press Space to check it. Now, you can close`
		`+ the dialogs.`
		`+`
		`+ Now, let's turn on a few more accessibility options. The text editor on the Mate`
		`+ desktop is Pluma. Open a Run dialog with Alt + F2, type mate-terminal, which has`
		`+ a dash between the two words, and press Enter. Now, in the terminal, type`
		`+`
		`+ pluma .bash_profile`
		`+`
		`+ and press Enter. You'll be in a text area. Press Control + End to go to the`
		`+ bottom of the file, and add the following lines.`
		`+`
		`+ export ACCESSIBILITY_ENABLED=1`
		`+ export GTK_MODULES=gail:atk-bridge`
		`+ export GNOME_ACCESSIBILITY=1`
		`+ export QT_ACCESSIBILITY=1`
		`+ export QT_LINUX_ACCESSIBILITY_ALWAYS_ON=1`
		`+`
		`+ Now, save the file, and close it. Restart the computer, and Orca should come up`
		`+ automatically, and all apps that are accessible will be accessible.`
		`+`
		`+ == Configuring Orca`
		`+`
		`+ To configure Orca, press Insert + Space. This will bring up a window with`
		`+ several tabs. Spend some time configuring Orca, then you can apply the changes`
		`+ to see how they work, before you close the window. If you want to learn Orca's`
		`+ keyboard commands, press Insert + H for "help." Then, you can press keys to see`
		`+ what they do, or press F2 to get a list of global commands, or F3 to get a list`
		`+ of application-specific commands.`
		`+`
		`+ == Other options and notes`
		`+`
		`+ To set a keyboard command for turning off and on Orca, go to the Keyboard`
		`+ Shortcuts preferences under Hardware preferences. You can also set the capslock,`
		`+ Windows, Alt, and other keys to act as other keys, like having the Capslock as`
		`+ an additional control. If you close a program, like VLC, and accessibility seems`
		`+ to freeze, press Insert + H, then F2 to bring up an accessible window. You may`
		`+ close the screen reader shortcuts afterwards. If Orca becomes unresponsive,`
		`+ restart it by opening the Run dialog, typing "orca -r", and pressing Enter.`
		`\ No newline at end of file`

modules/ROOT/pages/accessibility/installing-fedora-with-orca.adoc

file added

+88

		`@@ -0,0 +1,88 @@`
		`+ = Installing Fedora with Orca`
		`+`
		`+ Thanks for choosing to install Fedora. The first thing you'll need to do is put`
		`+ an installer onto a removable disk, like a DVD or Flash Drive. For maximum`
		`+ accessibility, choose Fedora's Mate spin, found at`
		`+ https://spins.fedoraproject.org/mate-compiz/download/index.html(The Fedora Mate`
		`+ download page). Follow a normal guide on flashing the downloaded image to a`
		`+ flash drive or DVD, and prepare to restart the computer to begin the`
		`+ installation.`
		`+`
		`+ To install Fedora Mate, hereafter referred to as just "Fedora", you'll`
		`+ need to start your computer with the installer's drive set as the`
		`+ drive the computer starts from. Consult your computer's manual for how`
		`+ to do this, but it is usually done by pressing the power button while`
		`+ the computer is still turned off, then quickly pressing a key, like`
		`+ F2, F8, F10, or F12, rapidly until the "boot manager" appears.`
		`+`
		`+ You'll need either sighted assistance, or an app on a smart phone that`
		`+ continuously reads text (like Seeing AI on the Apple App Store, or`
		`+ Google Lookout from the Google Play store), in order to somewhat know`
		`+ what's on the screen of this menu. If you have no other drives, local`
		`+ or network, connected to the computer, you may be able to press Down`
		`+ arrow or Right arrow several times to get to the last item of the`
		`+ menu, which should be your external drive, and press Enter to boot`
		`+ from it.`
		`+`
		`+ Now, with the continuous text scanner still on, you'll be in a menu`
		`+ for starting the installer. Pressing Enter should start it. Leave the`
		`+ continuous text scanning on until you hear the current date. Now, you`
		`+ can put down the phone; we won't need it anymore for the installation.`
		`+`
		`+ At this time, you are at the live installation screen, where you can`
		`+ enable Orca, the screen reader. To do this, hold down the Alt key, and press the`
		`+ F2 key, and release both keys. Now, type the word orca, all lowercase. You'll hear "screen reader`
		`+ on", in a robotic, British voice. If you press an arrow key, you'll find that`
		`+ you're on the desktop. This is a live system, so you are encouraged to play`
		`+ around with it.`
		`+`
		`+ == Navigating Linux`
		`+`
		`+ The Fedora installer uses a graphical interface, similar to the`
		`+ interfaces on other operating systems. Navigating it is similar to`
		`+ navigating other interfaces, with only a few differences. Use the Tab`
		`+ key to move from one control to another. Use Shift + Tab to navigate`
		`+ backward.`
		`+`
		`+ In text fields, use the Left and Right arrow keys to navigate by character, Control`
		`+ with Left and Right arrow to navigate by word, and Up and Down arrow`
		`+ to navigate by line. Use Home to go to the beginning of the line, End`
		`+ to go to the end of the line, and Control Home and Control End to go`
		`+ to the beginning and end of a text field. Use arrow keys to navigate`
		`+ lists, and the Space bar or Enter key to activate buttons, check`
		`+ boxes, and so on.`
		`+`
		`+ All that should be familiar to those who have used other operating systems. The`
		`+ differences are slight. In most programs, to move from one area of the screen to`
		`+ another, like a large list to the next group of controls, press Control + Tab.`
		`+ To move backward the same way, use Control + Shift + Tab. This will be useful in`
		`+ the installer. When a control cannot be used, you're probably used to hearing`
		`+ "disabled" or "dimmed". In Linux, Orca says that they are "grayed," meaning`
		`+ "grayed out."`
		`+`
		`+ Now that you know basic navigation, let's move on to installing the`
		`+ system.`
		`+`
		`+ == Installing Fedora`
		`+`
		`+ When you're done looking around, find the "install" icon on the desktop, and`
		`+ press Enter on it. The installer will open, but it won't have focus. To put`
		`+ focus on it, press Alt + Tab. Now, you can choose your language. When you've`
		`+ chosen your language, press Tab, and choose your keyboard layout. The item after`
		`+ that allows you to test your layout in a text field. Notice that Orca is`
		`+ speaking slowly, and also speaking every key you press. This can be changed`
		`+ later. Now, find the Next button and press Enter.`
		`+`
		`+ Now, you're in the main area of the installer. There are different areas you can`
		`+ go to, to prepare different parts of the installation. First is the destination,`
		`+ where Fedora will be installed. Then there are areas like time, user creation,`
		`+ and root account. Press Enter on them, one by one, and fill out the information`
		`+ in each. The part you may have trouble with is the time and timezone selection.`
		`+ The combo boxes in that area are hard to use, but you can fix your timezone`
		`+ later if you need to.`
		`+`
		`+ When you're ready, press the Begin Installation button. Fedora will begin to`
		`+ write the changes to the disk. When it's done, you can restart the computer. Be`
		`+ sure to remove the installation media, the DVD or Flash Drive, from the computer`
		`+ before restarting it or turning it back on. Now, you're ready to set up your new`
		`+ Fedora Linux system.`

modules/ROOT/pages/accessibility/why-choose-fedora.adoc

file added

+98

		`@@ -0,0 +1,98 @@`
		`+ = Why Choose Fedora Linux?`
		`+`
		`+ As other, proprietary, computer operating systems (OS) decline in`
		`+ accessibility, or fail to move forward on lofty promises, people with`
		`+ disabilities may begin looking for an alternative, particularly as`
		`+ computers that are more than three years old suddenly will not be`
		`+ supported by an OS upgrade. Many people with disabilities do not have`
		`+ a steady income, or cannot afford to spend the money they do have on`
		`+ a new computer just to keep their system current, secure, and`
		`+ future-proof.`
		`+`
		`+ Linux is a great option for many people to give computers, old and`
		`+ new, a much longer lifespan, with security based on Linux's years of`
		`+ real-world usage, and many great packages. Linux comes in many`
		`+ different "flavors," called "distributions." These distributions set`
		`+ the ground rules for your system, and many exist for many different`
		`+ types of people and situations.`
		`+`
		`+ Linux distributions, however, aren't always friendly to people with`
		`+ disabilities, particularly those that are blind or low-vision. From`
		`+ live images, for installation of the system, that do not include a`
		`+ screen reader, to desktop environments that are hard to use, Linux can`
		`+ be a struggle to use, and even more of one to enjoy.`
		`+`
		`+ There are currently`
		`+ https://en.wikipedia.org/wiki/Linux_distribution[almost 1000] Linux`
		`+ distributions in the world. Out of all of those, why should a person`
		`+ with disabilities choose Fedora? What sets it apart from all other`
		`+ distributions, including ones specifically made for people with disabilities?`
		`+`
		`+ == Software is Current`
		`+`
		`+ Most importantly, Fedora has current software. While other`
		`+ distributions pride themselves on stability, Fedora has an`
		`+ up-to-date set of accessibility tools, like Orca, for screen reading,`
		`+ and BRLTTY, for using Braille Displays. Each release of Fedora is`
		`+ followed by a steady stream of updates, keeping your system current`
		`+ and secure. This is especially important for screen reader users, as`
		`+ the Orca screen reader must evolve to work with the changes in both`
		`+ programs on the system and on the web.`
		`+`
		`+ == Easy to Install`
		`+`
		`+ Fedora's installer is easy to use, accessible (depending on which spin`
		`+ you use), and the live Image comes with the Orca screen reader ready`
		`+ to start. Users of Windows or MacOS will feel familiar with Orca and`
		`+ the installer, as keyboard commands are similar. There is no command`
		`+ line interface to worry about, or set of exotic keyboard commands to`
		`+ memorize.`
		`+`
		`+ == Learn and Improve`
		`+`
		`+ Fedora, like other Linux distributions, allows you to learn as you use`
		`+ the system. At first, you can do anything you need from a graphical`
		`+ interface. Then, as you learn and experiment, you may find that some`
		`+ processes you do, like daily work activities, are quicker to do in the`
		`+ terminal. Then, you may combine those typed lines in the terminal into`
		`+ a file for even easier automation. Afterwards, you may begin to learn`
		`+ to write code, and eventually, contribute to projects that interest`
		`+ you, or even improve your desktop environment or Fedora itself. Fedora`
		`+ allows this, whereas other operating systems hold you back from`
		`+ learning what makes them tick, and improving them for everyone.`
		`+`
		`+ This is important for people with disabilities because it allows the`
		`+ people who need the technology the most to not only use it, but learn`
		`+ to control, fix, and improve it. No proprietary system would allow`
		`+ that level of user-agency.`
		`+`
		`+ == A Welcoming Community`
		`+`
		`+ Fedora has a large and welcoming community. Whether you need help, or`
		`+ want to help, the community is there. You can interact with them on`
		`+ familiar Email lists or IRC. Distributions focused only on people with`
		`+ disabilities often have very small communities, which means that`
		`+ sometimes, new members don't get the help they need to stay on Linux,`
		`+ since a smaller community means that no one may know the answer or fix`
		`+ to a new member's problem.`
		`+`
		`+ == Analogous Technology`
		`+`
		`+ Below is a list of commonly used assistive technology on other`
		`+ platforms, and its Linux equivalent. The Linux version may do roughly`
		`+ the same functions as its counterparts, or do even more for the person`
		`+ using it.`
		`+`
		`+ JAWS, NVDA, VoiceOver, TalkBack::`
		`+ https://help.gnome.org/users/orca/stable/[Orca]`
		`+ Braille Display drivers:: https://brltty.app[BRLTTY, an entire screen`
		`+ reader for Braille displays, which also works with Orca.]`
		`+ Recognize inaccessible text on the screen::`
		`+ https://wiki.archlinux.org/title/Ocrdesktop[OCR Desktop: an Arch`
		`+ package that should be installable on Fedora]`
		`+ DuxBerry or BrailleBlaster::`
		`+ https://src.fedoraproject.org/rpms/cups-filters[Cups filters has`
		`+ drivers for Braille Embossers to be used like regular printers]`
		`+ Onscreen Keyboard::`
		`+ https://www.inference.org.uk/dasher/[Dasher is an onscreen keyboard`
		`+ similar to those on other operating systems]`

preview.sh

file modified

devinprater commented 2 years ago

This PR introduces accessibility documentation for Fedora. This is so that users are introduced to Fedora, learn how to install Fedora with the Orca screen reader, and know how to configure Fedora after installation, to be accessible. This is a roughdraft, so can be improved.

ankursinha commented on line 15 of modules/ROOT/pages/accessibility/after-installing-with-orca.adoc 2 years ago

We may need to break this down into individual sections based on desktop environment. I think Alt F1 in gnome doesn't do the same thing, for example. ("Super" will get one to the applications menu. )

ankursinha commented 2 years ago

I just have the one note for the moment. We need to add the pages to the nav.doc file so that they are listed in the left hand navigation bar, but I can do that once we merge this.

I think for an initial version, this is very very good. I'll see if we can get some folks from the anaconda and other desktop teams to add bits here too specific to these tools.

Thanks very much for kicking this off :)

Metadata Update from @ankursinha:
- Pull-request tagged with: improvement, needs changes, needs committer review, new change

2 years ago

devinprater commented 2 years ago

Thanks so much. I hope this can spark some discussion on how to make
getting started a bit easier, but I'm glad users will have at least a guide
of what to do and look out for. Thanks so much for accepting this.
Devin Prater
r.d.t.prater@gmail.com

On Thu, Jul 7, 2022 at 3:40 AM Ankur Sinha pagure@pagure.io wrote:

ankursinha commented on the pull-request: Accessibility docs that you
are following:
``
I just have the one note for the moment. We need to add the pages to the
nav.doc file so that they are listed in the left hand navigation bar, but I
can do that once we merge this.

I think for an initial version, this is very very good. I'll see if we can
get some folks from the anaconda and other desktop teams to add bits here
too specific to these tools.

Thanks very much for kicking this off :)
``

To reply, visit the link below or just reply to this email
https://pagure.io/fedora-docs/quick-docs/pull-request/469

ankursinha commented 2 years ago

I've merged this PR manually (pagure doesn't detect that, though). You can see the commits here, the accessibility pages should go live at the next build:

https://pagure.io/fedora-docs/quick-docs/commits/master

Pull-Request has been closed by ankursinha

2 years ago

ankursinha commented 2 years ago

@devinprater , since your PR was accepted, I've also added you to the quick-docs-committers group:

https://pagure.io/group/quick-docs-committers

Please feel free to open and review more pull requests etc. Please also feel free to make minor improvements to pages that you don't think merit pull requests.

Thanks again :rocket: