[tor-commits] [manual/develop] add alt attributes to images for accessibility

gus at torproject.org gus at torproject.org
Fri Jul 9 17:07:35 UTC 2021


commit 2ff958fb51a8f5d30c336d81fd742ff9f7b9338a
Author: Kim Le <kle2 at student.unimelb.edu.au>
Date:   Fri Oct 23 07:22:55 2020 +1100

    add alt attributes to images for accessibility
---
 content/bridges/contents.lr             |  4 ++--
 content/managing-identities/contents.lr |  4 ++--
 content/running-tor-browser/contents.lr | 10 +++++-----
 content/security-settings/contents.lr   |  4 ++--
 content/troubleshooting/contents.lr     |  2 +-
 content/updating/contents.lr            |  4 ++--
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/content/bridges/contents.lr b/content/bridges/contents.lr
index 608fc29..ec6c614 100644
--- a/content/bridges/contents.lr
+++ b/content/bridges/contents.lr
@@ -27,7 +27,7 @@ Because bridge addresses are not public, you will need to request them yourself.
 
 ### USING MOAT
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/request-a-bridge.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/request-a-bridge.png" alt="Request a bridge from torproject.org">
 
 If you're starting Tor Browser for the first time, click "Configure" to open the Tor Network Settings window.
 After checking the checkbox "Tor is censored in my country," choose "Request a bridge from torproject.org" and click "Request a Bridge..." for BridgeDB to provide a bridge.
@@ -39,7 +39,7 @@ Complete the CAPTCHA and click "Submit." Your setting will automatically be save
 
 ### ENTERING BRIDGE ADDRESSES
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/tor-launcher-custom-bridges.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/tor-launcher-custom-bridges.png" alt="Enter custom bridge addresses">
 
 Once you have obtained some bridge addresses, you will need to enter them into Tor Launcher.
 
diff --git a/content/managing-identities/contents.lr b/content/managing-identities/contents.lr
index 7fb5bf2..228e972 100644
--- a/content/managing-identities/contents.lr
+++ b/content/managing-identities/contents.lr
@@ -20,7 +20,7 @@ Tor Browser centers your web experience around your relationship with the websit
 
 On the other hand, all connections to a single website address will be made over the same Tor circuit, meaning you can browse different pages of a single website in separate tabs or windows, without any loss of functionality.
 
-<img class="col-md-6" align="right" hspace="5" src="../../static/images/circuit_full.png">
+<img class="col-md-6" align="right" hspace="5" src="../../static/images/circuit_full.png" alt="Display circuit diagram under the site information menu">
 
 You can see a diagram of the circuit that Tor Browser is using for the current tab in the site information menu, in the URL bar.
 
@@ -39,7 +39,7 @@ When you log in to a website over Tor, there are several points you should bear
 
 ### CHANGING IDENTITIES AND CIRCUITS
 
-<img class="col-md-6" src="../../static/images/new_identity.png">
+<img class="col-md-6" src="../../static/images/new_identity.png" alt="New Identity and New Tor Circuit options under main menu">
 
 Tor Browser features “New Identity” and “New Tor Circuit for this Site” options. There are also located in the main menu (hamburger menu).
 
diff --git a/content/running-tor-browser/contents.lr b/content/running-tor-browser/contents.lr
index 2de889c..708d277 100644
--- a/content/running-tor-browser/contents.lr
+++ b/content/running-tor-browser/contents.lr
@@ -15,7 +15,7 @@ This offers you the option to connect directly to the Tor network, or to configu
 
 ### CONNECT
 
-<img class="col-md-6" src="../../static/images/connect.png">
+<img class="col-md-6" src="../../static/images/connect.png" alt="Click 'connect' to connect to Tor.">
 
 In most cases, choosing "Connect" will allow you to connect to the Tor network without any further configuration.
 Once clicked, a status bar will appear, showing Tor’s connection progress.
@@ -23,22 +23,22 @@ If you are on a relatively fast connection, but this bar seems to get stuck at a
 
 ### CONFIGURE
 
-<img class="col-md-6" src="../../static/images/configure.png">
+<img class="col-md-6" src="../../static/images/configure.png" alt="Click 'configure' to adjust network settings.">
 
 If you know that your connection is censored or uses a proxy, you should select this option.
 
-<img class="col-md-6" src="../../static/images/proxy_question.png">
+<img class="col-md-6" src="../../static/images/proxy_question.png" alt="Select options for censored connection or proxy use.">
 
 Tor Browser will take you through a series of configuration options.
 
-<img class="col-md-6" src="../../static/images/pluggable-transport.png">
+<img class="col-md-6" src="../../static/images/pluggable-transport.png" alt="Configure Tor bridge options">
 
 The first checkbox asks if access to the Tor network is blocked or censored on your connection.
 If you do not believe this is the case, leave this unchecked.
 If you know your connection is censored, or you have tried and failed to connect to the Tor network and no other solutions have worked, check the checkbox.
 This will display the [Circumvention](../circumvention) section to configure a pluggable transport.
 
-<img class="col-md-6" src="../../static/images/proxy.png">
+<img class="col-md-6" src="../../static/images/proxy.png" alt="Configure proxy options">
 
 The second checkbox asks if your connection uses a proxy. In most cases, this is not necessary. You will usually know if you need to check this checkbox because the same settings will be used for other browsers on your system.
 If possible, ask your network administrator for guidance.
diff --git a/content/security-settings/contents.lr b/content/security-settings/contents.lr
index c799b30..b348822 100644
--- a/content/security-settings/contents.lr
+++ b/content/security-settings/contents.lr
@@ -19,14 +19,14 @@ Increasing Tor Browser's security level will stop some web pages from functionin
 The Security Settings can be accessed by clicking the Shield icon next to the Tor Browser URL bar.
 To view and adjust your Security Settings, click the 'Advanced Security Settings...' button in the shield menu.
 
-<img class="col-lg-6" src="../../static/images/security-settings-anim.gif">
+<img class="col-lg-6" src="../../static/images/security-settings-anim.gif" alt="Click on 'Advanced Security Settings' under the shield menu.">
 
 ### SECURITY LEVELS
 
 Increasing the Security Level in the Tor Browser Security Settings will disable or partially disable certain browser features to protect against possible attacks.
 You can enable these settings again at any time by adjusting your Security Level.
 
-<img class="col-lg-6" src="../../static/images/security-settings-safest.png">
+<img class="col-lg-6" src="../../static/images/security-settings-safest.png" alt="Security Level is currently set to Standard.">
 
 
 ###### Standard
diff --git a/content/troubleshooting/contents.lr b/content/troubleshooting/contents.lr
index a1b2a93..ec70570 100644
--- a/content/troubleshooting/contents.lr
+++ b/content/troubleshooting/contents.lr
@@ -11,7 +11,7 @@ key: 12
 body:
 You should be able to start browsing the web using Tor Browser shortly after running the program, and clicking the “Connect” button if you are using it for the first time.
 
-<img class="col-md-6" src="../../static/images/connect.png">
+<img class="col-md-6" src="../../static/images/connect.png" alt="Click 'Connect' to connect to Tor.">
 
 ### QUICK FIXES
 
diff --git a/content/updating/contents.lr b/content/updating/contents.lr
index 1580f56..6c5b14a 100644
--- a/content/updating/contents.lr
+++ b/content/updating/contents.lr
@@ -15,11 +15,11 @@ Tor Browser will prompt you to update the software once a new version has been r
 
 ### UPDATING TOR BROWSER AUTOMATICALLY
 
-  <img width="400" src="../../static/images/update1.png" />
+  <img width="400" src="../../static/images/update1.png" alt="Select 'Restart to update Tor Browser' under the main menu"/>
 
 When you are prompted to update Tor Browser, click on hamburger menu (main menu), then select “Restart to update Tor browser”.
 
-  <img width="500" src="../../static/images/update4.png" />
+  <img width="500" src="../../static/images/update4.png" alt="Update progress bar"/>
 
 Wait for the update to download and install, then Tor Browser will restart itself. You will now be running the latest version.
 





More information about the tor-commits mailing list