From ba4cf3c8500ffdef349565e63a36f825edb76903 Mon Sep 17 00:00:00 2001
From: Joe Fernandez <joefernandez@google.com>
Date: Wed, 1 Aug 2012 16:21:17 -0700
Subject: [PATCH] docs: Accessibility DevGuide, Jelly Bean edition

Change-Id: Idafa0d755c0397b539a6de5b10096abc1c06c2c7
---
 docs/html/guide/guide_toc.cs                  |  43 +-
 .../guide/topics/ui/accessibility/apps.jd     | 422 +++++++++++-------
 .../topics/ui/accessibility/calendar.png      | Bin 0 -> 17811 bytes
 .../topics/ui/accessibility/checklist.jd      | 173 +++++++
 .../guide/topics/ui/accessibility/index.jd    |  62 ++-
 .../guide/topics/ui/accessibility/services.jd | 273 ++++++++---
 .../tools/testing/testing_accessibility.jd    | 257 +++++++++++
 docs/html/tools/tools_toc.cs                  |  32 +-
 8 files changed, 1001 insertions(+), 261 deletions(-)
 create mode 100644 docs/html/guide/topics/ui/accessibility/calendar.png
 create mode 100644 docs/html/guide/topics/ui/accessibility/checklist.jd
 create mode 100644 docs/html/tools/testing/testing_accessibility.jd

diff --git a/docs/html/guide/guide_toc.cs b/docs/html/guide/guide_toc.cs
index 9465f1882a06c..e812ccbc7b251 100644
--- a/docs/html/guide/guide_toc.cs
+++ b/docs/html/guide/guide_toc.cs
@@ -8,7 +8,7 @@
 <ul id="nav">
   <!--  Walkthrough for Developers -- quick overview of what it's like to develop on Android -->
   <!--<li style="color:red">Overview</li> -->
-  
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/components/index.html">
         <span class="en">App Components</span>
@@ -223,7 +223,7 @@
             <li><a href="<?cs var:toroot ?>guide/topics/search/adding-custom-suggestions.html">Adding Custom Suggestions</a></li>
             <li><a href="<?cs var:toroot ?>guide/topics/search/searchable-config.html">Searchable Configuration</a></li>
           </ul>
-      </li>  
+      </li>
       <li><a href="<?cs var:toroot ?>guide/topics/ui/drag-drop.html">
           <span class="en">Drag and Drop</span>
         </a></li>
@@ -235,6 +235,9 @@
           <li><a href="<?cs var:toroot ?>guide/topics/ui/accessibility/apps.html">
               <span class="en">Making Applications Accessible</span>
             </a></li>
+          <li><a href="<?cs var:toroot ?>guide/topics/ui/accessibility/checklist.html">
+              <span class="en">Accessibility Developer Checklist</span>
+            </a></li>
           <li><a href="<?cs var:toroot ?>guide/topics/ui/accessibility/services.html">
               <span class="en">Building Accessibility Services</span>
             </a></li>
@@ -382,9 +385,9 @@
             </a></li>
         </ul>
       </li><!-- end of location and sensors -->
-      
 
-      
+
+
       <li class="nav-section">
         <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/connectivity/index.html">
                <span class="en">Connectivity</span>
@@ -419,10 +422,10 @@
             <span class="en">SIP</span>
           </a>
      </li>
-     
+
     </ul>
   </li><!-- end of connectivity -->
-  
+
       <li class="nav-section">
         <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/text/index.html">
             <span class="en">Text and Input</span>
@@ -439,7 +442,7 @@
             </a></li>
         </ul>
       </li><!-- end of text and input -->
-      
+
      <li class="nav-section">
       <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/data/index.html">
           <span class="en">Data Storage</span>
@@ -457,7 +460,7 @@
       </ul>
     </li><!-- end of data storage -->
 
-  
+
   <li class="nav-section">
            <div class="nav-section-header"><a href="<?cs var:toroot?>guide/topics/admin/index.html">
                <span class="en">Administration</span>
@@ -475,7 +478,7 @@
             -->
            </ul>
   </li><!-- end of administration -->
-  
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/webapps/index.html">
     <span class="en">Web Apps</span>
@@ -498,7 +501,7 @@
           </a></li>
     </ul>
   </li><!-- end of web apps -->
-  
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/index.html">
       <span class="en">Best Practices</span>
@@ -555,13 +558,13 @@
 
     </ul>
   </li>
-  
-  
+
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/google/index.html">
         <span class="en">Google Services</span>
       </a></div>
-    <ul>      
+    <ul>
 
       <li class="nav-section">
         <div class="nav-section-header"><a href="<?cs var:toroot?>guide/google/play/billing/index.html">
@@ -623,7 +626,7 @@
       <li><a href="<?cs var:toroot ?>guide/google/play/expansion-files.html">
           <span class="en">APK Expansion Files</span></a>
       </li>
-      
+
       <li class="nav-section">
         <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/google/gcm/index.html">
           <span class="en">Google Cloud Messaging</span></a>
@@ -649,9 +652,9 @@
 
     </ul>
   </li><!-- end Google Play -->
-  
-  
-  
+
+
+
       <!-- this needs to move
       <li class="nav-section">
         <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/practices/ui_guidelines/index.html">
@@ -691,9 +694,9 @@
               </a></div>
           </li>
         </ul>
-      </li> 
+      </li>
         </ul> -->
-        
+
 <!-- Remove
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot ?>guide/appendix/index.html">
@@ -710,7 +713,7 @@
       <li><a href="<?cs var:toroot ?>guide/appendix/g-app-intents.html">
             <span class="en">Intents List: Google Apps</span>
           </a></li>
-       
+
 
       <li><a href="<?cs var:toroot ?>guide/appendix/glossary.html">
             <span class="en">Glossary</span>
diff --git a/docs/html/guide/topics/ui/accessibility/apps.jd b/docs/html/guide/topics/ui/accessibility/apps.jd
index d23512b3e1154..13b4538edeb77 100644
--- a/docs/html/guide/topics/ui/accessibility/apps.jd
+++ b/docs/html/guide/topics/ui/accessibility/apps.jd
@@ -21,14 +21,11 @@ parent.link=index.html
         <li><a href="#accessibility-methods">Implementing accessibility API methods</a></li>
         <li><a href="#send-events">Sending accessibility events</a></li>
         <li><a href="#populate-events">Populating accessibility events</a></li>
+        <li><a href="#virtual-hierarchy">Providing a customized accessibility context</a></li>
+        <li><a href="#custom-touch-events">Handling custom touch events</a></li>
       </ol>
     </li>
-    <li><a href="#test">Testing Accessibility</a>
-      <ol>
-        <li><a href="#test-audibles">Testing audible feedback</a></li>
-        <li><a href="#test-navigation">Testing focus navigation</a></li>
-      </ol>
-    </li>
+    <li><a href="#test">Testing Accessibility</a></li>
   </ol>
 
   <h2>Key classes</h2>
@@ -42,60 +39,79 @@ parent.link=index.html
 
   <h2>See also</h2>
   <ol>
-    <li><a href="{@docRoot}training/accessibility/index.html">Implementing Accessibility</a></li>
-    <li><a href="{@docRoot}training/design-navigation/index.html">Designing Effective Navigation</a>
-      </li>
-    <li><a href="{@docRoot}design/index.html">Android Design</a></li>
+    <li><a href="checklist.html">Accessibility Developer Checklist</a><li>
+    <li><a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing Checklist</a><li>
+    <li><a href="{@docRoot}design/patterns/accessibility.html">Android Design: Accessibility</a></li>
+    <li><a href="{@docRoot}training/design-navigation/index.html">Designing Effective Navigation</a></li>
+    <li><a href="{@docRoot}training/accessibility/index.html">Training: Implementing Accessibility</a></li>
   </ol>
 
 </div>
 </div>
 
-<p>Applications built for Android are accessible to users with visual, physical or age-related
-disabilities when they activate accessibility features and services on a device. By default,
-these services make your application more accessible. However, there are further steps you should
-take to optimize the accessibility of your application and ensure a pleasant experience for all your
-users.</p>
+<p>Applications built for Android are more accessible to users with visual, physical or age-related
+limitations when those users activate accessibility services and features on a device. These
+services make your application more accessible even if you do not make any accessibility changes
+to your code. However, there are steps you should take to optimize the accessibility of your
+application and ensure a pleasant experience for all your users.</p>
 
-<p>Making sure your application is accessible to all users is relatively easy, particularly when you
-use framework-provided user interface components. If you only use these standard components for your
-application, there are just a few steps required to ensure your application is accessible:</p>
+<p>Making sure your application is accessible to all users requires only a few steps, particularly
+when you create your user interface with the components provided by the Android framework. If you
+use only the standard components for your application, the steps are:</p>
 
 <ol>
-  <li>Label your {@link android.widget.ImageButton}, {@link android.widget.ImageView}, {@link
-android.widget.EditText}, {@link android.widget.CheckBox} and other user interface controls using
-the <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
-    {@code android:contentDescription}</a> attribute.</li>
-  <li>Make all of your user interface elements accessible with a directional controller,
-    such as a trackball or D-pad.</li>
-  <li>Test your application by turning on accessibility services like TalkBack and Explore by
-    Touch, and try using your application using only directional controls.</li>
+  <li>Add descriptive text to user interface controls in your application using the
+    <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
+    {@code android:contentDescription}</a> attribute. Pay particular attention to
+    {@link android.widget.ImageButton}, {@link android.widget.ImageView}
+    and {@link android.widget.CheckBox}.</li>
+  <li>Make sure that all user interface elements that can accept input (touches or typing) can be
+    reached with a directional controller, such as a trackball, D-pad (physical or virtual) or
+    navigation <a href="http://support.google.com/android/bin/topic.py?hl=en&topic=2492346">gestures
+    </a>.</li>
+  <li>Make sure that audio prompts are always accompanied by another visual prompt or notification,
+    to assist users who are deaf or hard of hearing.</li>
+  <li>Test your application using only accessibility navigation services and features. Turn on
+    <a href="{@docRoot}tools/testing/testing_accessibility.html#testing-talkback">TalkBack</a> and
+    <a href="{@docRoot}tools/testing/testing_accessibility.html#testing-ebt">Explore by Touch</a>,
+    and then try using your application using only directional controls. For more information on
+    testing for accessibility, see the <a href="{@docRoot}tools/testing/testing_accessibility.html">
+    Accessibility Testing Checklist</a>.</li>
 </ol>
 
-<p>Developers who create custom controls that extend from the {@link android.view.View} class have
-some additional responsibilities for making sure their components are accessible for users. This
-document also discusses how to make custom view controls compatible with accessibility services.</p>
+<p>If you build custom controls that extend the {@link android.view.View} class, you must complete
+some additional work to make sure your components are accessible. This document discusses how to
+make custom view controls compatible with accessibility services.</p>
+
+<p class="note">
+<strong>Note:</strong> The implementation steps in this document describe the requirements for
+making your application accessible for users with blindness or low-vision. Be sure to review the
+requirements for serving users who are deaf and hard of hearing in the
+<a href="{@docRoot}guide/topics/ui/accessibility/checklist.html">Accessibility Developer
+Checklist</a></p>.
+
 
 
 <h2 id="label-ui">Labeling User Interface Elements</h2>
 
-<p>Many user interface controls rely on visual cues to inform users of their meaning. For
+<p>Many user interface controls depend on visual cues to indicate their meaning and usage. For
 example, a note-taking application might use an {@link android.widget.ImageButton} with a
-picture of a plus sign to indicate that the user can add a new note. Or, an {@link
-android.widget.EditText} component may have a label near it that indicates its purpose. When a user
-with impaired vision accesses your application, these visual cues are often useless.</p>
+picture of a plus sign to indicate that the user can add a new note. An {@link
+android.widget.EditText} component may have a label near it that indicates its purpose. A user
+with impaired vision can't see these cues well enough to follow them, which makes them useless.</p>
 
-<p>To provide textual information about interface controls (as an alternative to the visual cues),
-use the <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
-{@code android:contentDescription}</a> attribute. The text you provide in this attribute is not
-visible on the screen, but if a user has enabled accessibility services that provide audible
-prompts, then the description in this attribute is read aloud to the user.</p>
+<p>You can make these controls more accessible with the
+<a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
+{@code android:contentDescription}</a> XML layout attribute. The text in this attribute does not
+appear on screen, but if the user enables accessibility services that provide audible prompts, then
+when the user navigates to that control, the text is spoken.</p>
 
-<p>Set the <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
+<p>For this reason, set the
+<a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
 {@code android:contentDescription}</a> attribute for every {@link android.widget.ImageButton},
-{@link android.widget.ImageView}, {@link android.widget.EditText}, {@link android.widget.CheckBox}
-in your application's user interface, and on any other input controls that might require additional
-information for users who are not able to see it.</p>
+{@link android.widget.ImageView}, {@link android.widget.CheckBox}
+in your application's user interface, and add descriptions to any other input controls that might
+require additional information for users who are not able to see it.</p>
 
 <p>For example, the following {@link android.widget.ImageButton} sets the content description for
 the plus button to the {@code add_note} string resource, which could be defined as “Add note" for an
@@ -108,32 +124,38 @@ English language interface:</p>
     android:contentDescription=”@string/add_note”/&gt;
 </pre>
 
-<p>By including the description, speech-based accessibility services can announce "Add note" when a
-user moves focus to this button or hovers over it.</p>
+<p>By including the description, an accessibility service that provides spoken feedback can announce
+"Add note" when a user moves focus to this button or hovers over it.</p>
 
 <p class="note"><strong>Note:</strong> For {@link android.widget.EditText} fields, provide an
 <a href="{@docRoot}reference/android/widget/TextView.html#attr_android:hint">android:hint</a>
-attribute to help users understand what content is expected.</p>
+attribute <em>instead</em> of a content description, to help users understand what content is
+expected when the text field is empty. When the field is filled, TalkBack reads the entered
+content to the user, instead of the hint text.</p>
+
 
 <h2 id="focus-nav">Enabling Focus Navigation</h2>
 
 <p>Focus navigation allows users with disabilities to step through user interface controls using a
-directional controller. Directional controllers can be physical, such as a clickable trackball,
-directional pad (D-pad) or arrow keys, tab key navigation with an attached keyboard or a software
-application, such as the
+directional controller. Directional controllers can be physical, such as a trackball, directional
+pad (D-pad) or arrow keys, or virtual, such as the
 <a href="https://play.google.com/store/apps/details?id=com.googlecode.eyesfree.inputmethod.latin">
-Eyes-Free Keyboard</a>, that provides an on-screen directional control.</p>
+Eyes-Free Keyboard</a>, or the gestures navigation mode available in Android 4.1 and higher.
+Directional controllers are a primary means of navigation for many Android users.
+</p>
+
+<p>To ensure that users can navigate your application using only a directional controller, verify
+that all user interface (UI) input controls in your application can be reached and activated
+without using the touchscreen. You should also verify that clicking with the center button (or OK
+button) of a directional controller has the same effect as touching a control that already has
+focus. For information on testing directional controls, see
+<a href="{@docRoot}tools/testing/testing_accessibility.html#test-navigation">Testing
+focus navigation</a>.</p>
 
-<p>A directional controller is a primary means of navigation for many users.
-Verify that all user interface (UI) controls in your application are accessible
-without using the touchscreen and that clicking with the center button (or OK button) of a
-directional controller has the same effect as touching the controls on the touchscreen. For
-information on testing directional controls, see <a href="#test-navigation">Testing focus
-navigation</a>.</p>
 
 <h3 id="focus-enable">Enabling view focus</h3>
 
-<p>A user interface element is accessible using directional controls when its
+<p>A user interface element is reachable using directional controls when its
 <a href="{@docRoot}reference/android/view/View.html#attr_android:focusable">
 {@code android:focusable}</a> attribute is set to {@code true}. This setting allows users to focus
 on the element using the directional controls and then interact with it. The user interface controls
@@ -149,44 +171,44 @@ and even request that a control be given focus:</p>
   <li>{@link android.view.View#requestFocus requestFocus()}</li>
 </ul>
 
-<p>When working with a view that is not focusable by default, you can make it focusable from the XML
-layout file by setting the
-<a href="{@docRoot}reference/android/view/View.html#attr_android:focusable">
-{@code android:focusable}</a> attribute to {@code true} or by using the {@link
+<p>If a view is not focusable by default, you can make it focusable in your layout file by setting
+the <a href="{@docRoot}reference/android/view/View.html#attr_android:focusable">
+{@code android:focusable}</a> attribute to {@code true} or by calling the its {@link
 android.view.View#setFocusable setFocusable()} method.</p>
 
+
 <h3 id="focus-order">Controlling focus order</h3>
 
 <p>When users navigate in any direction using directional controls, focus is passed from one
-user interface element (View) to another, as determined by the focus ordering. The ordering of the
-focus movement is based on an algorithm that finds the nearest neighbor in a given direction. In
-rare cases, the default algorithm may not match the order that you intended for your UI. In these
-situations, you can provide explicit overrides to the ordering using the following XML attributes in
-the layout file:</p>
+user interface element (view) to another, as determined by the focus order. This order is based on
+an algorithm that finds the nearest neighbor in a given direction. In rare cases, the algorithm may
+not match the order that you intended or may not be logical for users. In these situations, you can
+provide explicit overrides to the ordering using the following XML attributes in your layout file:
+</p>
 
 <dl>
- <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusDown"
->{@code android:nextFocusDown}</a></dt>
-  <dd>Defines the next view to receive focus when the user navigates down.</dd>
- <a><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusLeft"
->{@code android:nextFocusLeft}</a></dt>
-  <dd>Defines the next view to receive focus when the user navigates left.</dd>
- <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusRight"
->{@code android:nextFocusRight}</a></dt>
-  <dd>Defines the next view to receive focus when the user navigates right.</dd>
- <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusUp"
->{@code android:nextFocusUp}</a></dt>
-  <dd>Defines the next view to receive focus when the user navigates up.</dd>
+  <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusDown">
+  {@code android:nextFocusDown}</a></dt>
+    <dd>Defines the next view to receive focus when the user navigates down.</dd>
+  <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusLeft">
+  {@code android:nextFocusLeft}</a></dt>
+    <dd>Defines the next view to receive focus when the user navigates left.</dd>
+  <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusRight">
+  {@code android:nextFocusRight}</a></dt>
+    <dd>Defines the next view to receive focus when the user navigates right.</dd>
+  <dt><a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusUp">
+  {@code android:nextFocusUp}</a></dt>
+    <dd>Defines the next view to receive focus when the user navigates up.</dd>
 </dl>
 
-<p>The following example XML layout shows two focusable user interface elements where the <a
-href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusDown"
->{@code android:nextFocusDown}</a> and <a
-href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusUp"
->{@code android:nextFocusUp}</a> attributes have been explicitly set. The {@link android.widget.TextView} is
+<p>The following example XML layout shows two focusable user interface elements where the
+<a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusDown">{@code
+android:nextFocusDown}</a> and
+<a href="{@docRoot}reference/android/view/View.html#attr_android:nextFocusUp">{@code
+android:nextFocusUp}</a> attributes have been explicitly set. The {@link android.widget.TextView} is
 located to the right of the {@link android.widget.EditText}. However, since these properties have
 been set, the {@link android.widget.TextView} element can now be reached by pressing the down arrow
-when focus is on the {@link android.widget.EditText} element: </p>
+when focus is on the {@link android.widget.EditText} element:</p>
 
 <pre>
 &lt;LinearLayout android:orientation="horizontal"
@@ -218,8 +240,9 @@ These are the main tasks for ensuring the accessibility of your view:</p>
 
 <ul>
   <li>Handle directional controller clicks</li>
-  <li>Implement Accessibility API methods</li>
-  <li>Send {@link android.view.accessibility.AccessibilityEvent} objects specific to your custom view</li>
+  <li>Implement accessibility API methods</li>
+  <li>Send {@link android.view.accessibility.AccessibilityEvent} objects specific to your custom
+    view</li>
   <li>Populate {@link android.view.accessibility.AccessibilityEvent} and {@link
     android.view.accessibility.AccessibilityNodeInfo} for your view</li>
 </ul>
@@ -243,9 +266,9 @@ full keyboard much easier for users.</p>
 
 <p>Accessibility events are messages about users interaction with visual interface components in
 your application. These messages are handled by <a href="services.html">Accessibility Services</a>,
-which use the information in these events to produce supplemental feedback and prompts when users
-have enabled accessibility services. As of Android 4.0 (API Level 14) and higher, the methods for
-generating accessibility events have been expanded to provide more detailed information beyond the
+which use the information in these events to produce supplemental feedback and prompts. In
+Android 4.0 (API Level 14) and higher, the methods for
+generating accessibility events have been expanded to provide more detailed information than the
 {@link android.view.accessibility.AccessibilityEventSource} interface introduced in Android 1.6 (API
 Level 4). The expanded accessibility methods are part of the {@link android.view.View} class as well
 as the {@link android.view.View.AccessibilityDelegate} class. The methods are as follows:</p>
@@ -262,12 +285,12 @@ sendAccessibilityEventUnchecked()}</dt>
   <dd>(API Level 4) This method is used when the calling code needs to directly control the check
 for accessibility being enabled on the device ({@link
 android.view.accessibility.AccessibilityManager#isEnabled AccessibilityManager.isEnabled()}). If
-you do implement this method, you must assume that the calling method has already checked that
-accessibility is enabled and the result is {@code true}. You typically do not need to implement this
-method for a custom view.</dd>
+you do implement this method, you must perform the call as if accessibility is enabled, regardless
+of the actual system setting. You typically do not need to implement this method for a custom view.
+</dd>
 
   <dt>{@link android.view.View#dispatchPopulateAccessibilityEvent
-dispatchPopulateAccessibilityEvent()} </dt>
+dispatchPopulateAccessibilityEvent()}</dt>
   <dd>(API Level 4) The system calls this method when your custom view generates an
 accessibility event. As of API Level 14, the default implementation of this method calls {@link
 android.view.View#onPopulateAccessibilityEvent onPopulateAccessibilityEvent()} for this view and
@@ -276,21 +299,21 @@ dispatchPopulateAccessibilityEvent()} method for each child of this view. In ord
 accessibility services on revisions of Android <em>prior</em> to 4.0 (API Level 14) you
 <em>must</em> override this method and populate {@link
 android.view.accessibility.AccessibilityEvent#getText} with descriptive text for your custom
-view.</dd>
+view, which is spoken by accessibility services, such as TalkBack.</dd>
 
   <dt>{@link android.view.View#onPopulateAccessibilityEvent onPopulateAccessibilityEvent()}</dt>
-  <dd>(API Level 14) This method sets the text output of an {@link
+  <dd>(API Level 14) This method sets the spoken text prompt of the {@link
 android.view.accessibility.AccessibilityEvent} for your view. This method is also called if the
 view is a child of a view which generates an accessibility event.
 
   <p class="note"><strong>Note:</strong> Modifying additional attributes beyond the text within
-this method potentially overwrites properties set by other methods. So, while you are able modify
+this method potentially overwrites properties set by other methods. While you can modify
 attributes of the accessibility event with this method, you should limit these changes
-to text content only and use the {@link android.view.View#onInitializeAccessibilityEvent
+to text content, and use the {@link android.view.View#onInitializeAccessibilityEvent
 onInitializeAccessibilityEvent()} method to modify other properties of the event.</p>
 
-  <p class="note"><strong>Note:</strong> If your implementation of this event calls for completely
-overiding the output text without allowing other parts of your layout to modify its content, then
+  <p class="note"><strong>Note:</strong> If your implementation of this event completely
+overrides the output text without allowing other parts of your layout to modify its content, then
 do not call the super implementation of this method in your code.</p>
   </dd>
 
@@ -306,7 +329,7 @@ that have not been set by the super class.</dd>
   <dt>{@link android.view.View#onInitializeAccessibilityNodeInfo
 onInitializeAccessibilityNodeInfo()}</dt>
   <dd>(API Level 14) This method provides accessibility services with information about the state of
-the view. The default {@link android.view.View} implementation sets a standard set of view
+the view. The default {@link android.view.View} implementation has a standard set of view
 properties, but if your custom view provides interactive control beyond a simple {@link
 android.widget.TextView} or {@link android.widget.Button}, you should override this method and set
 the additional information about your view into the {@link
@@ -315,7 +338,7 @@ android.view.accessibility.AccessibilityNodeInfo} object handled by this method.
   <dt>{@link android.view.ViewGroup#onRequestSendAccessibilityEvent
 onRequestSendAccessibilityEvent()}</dt>
   <dd>(API Level 14) The system calls this method when a child of your view has generated an
-{@link android.view.accessibility.AccessibilityEvent}. This step allows the the parent view to amend
+{@link android.view.accessibility.AccessibilityEvent}. This step allows the parent view to amend
 the accessibility event with additional information. You should implement this method only if your
 custom view can have child views and if the parent view can provide context information to the
 accessibility event that would be useful to accessibility services.</dd>
@@ -333,7 +356,7 @@ higher, to your project. Then, within your custom view class, call the
 {@link android.support.v4.view.ViewCompat#setAccessibilityDelegate
 ViewCompat.setAccessibilityDelegate()} method to implement the accessibility methods
 above. For an example of this approach, see the Android Support Library (revision 5 or higher)
-sample {@code AccessibilityDelegateSupportActivity} in 
+sample {@code AccessibilityDelegateSupportActivity} in
 ({@code &lt;sdk&gt;/extras/android/support/v4/samples/Support4Demos/})
   </li>
 </ul>
@@ -446,20 +469,20 @@ public void dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
 }
 </pre>
 
-<p>On Android 4.0 (API Level 14) and higher, the {@link
+<p>For Android 4.0 (API Level 14) and higher, use the {@link
 android.view.View#onPopulateAccessibilityEvent onPopulateAccessibilityEvent()} and
 {@link android.view.View#onInitializeAccessibilityEvent onInitializeAccessibilityEvent()}
-methods are the recommended way to populate or modify the information in an {@link
-android.view.accessibility.AccessibilityEvent}. Use the 
+methods to populate or modify the information in an {@link
+android.view.accessibility.AccessibilityEvent}. Use the
 {@link android.view.View#onPopulateAccessibilityEvent onPopulateAccessibilityEvent()} method
 specifically for adding or modifying the text content of the event, which is turned into audible
 prompts by accessibility services such as TalkBack. Use the
 {@link android.view.View#onInitializeAccessibilityEvent onInitializeAccessibilityEvent()} method for
 populating additional information about the event, such as the selection state of the view.</p>
 
-<p>In addition, you should also implement the
+<p>In addition, implement the
 {@link android.view.View#onInitializeAccessibilityNodeInfo onInitializeAccessibilityNodeInfo()}
-method. {@link android.view.accessibility.AccessibilityNodeInfo} objects populated by this method
+method. The {@link android.view.accessibility.AccessibilityNodeInfo} objects populated by this method
 are used by accessibility services to investigate the view hierarchy that generated an accessibility
 event after receiving that event, to obtain a more detailed context information and provide
 appropriate feedback to users.</p>
@@ -467,8 +490,8 @@ appropriate feedback to users.</p>
 <p>The example code below shows how override these three methods by using
 {@link android.support.v4.view.ViewCompat#setAccessibilityDelegate
 ViewCompat.setAccessibilityDelegate()}. Note that this sample code requires that the Android
-<a href="{@docRoot}tools/extras/support-library.html">Support Library</a> for API Level 4 (revision 5
-or higher) is added to your project.</p>
+<a href="{@docRoot}tools/extras/support-library.html">Support Library</a> for API Level 4 (revision
+5 or higher) is added to your project.</p>
 
 <pre>
 ViewCompat.setAccessibilityDelegate(new AccessibilityDelegateCompat() {
@@ -509,10 +532,10 @@ ViewCompat.setAccessibilityDelegate(new AccessibilityDelegateCompat() {
 }
 </pre>
 
-<p>On applications targeting Android 4.0 (API Level 14) and higher, these methods can be implemented
+<p>In applications targeting Android 4.0 (API Level 14) and higher, you can implement these methods
 directly in your custom view class. For another example of this approach, see the Android
-<a href="{@docRoot}tools/extras/support-library.html">Support Library</a> (revision 5 or higher) sample
-{@code AccessibilityDelegateSupportActivity} in 
+<a href="{@docRoot}tools/extras/support-library.html">Support Library</a> (revision 5 or higher)
+sample {@code AccessibilityDelegateSupportActivity} in
 ({@code &lt;sdk&gt;/extras/android/support/v4/samples/Support4Demos/}).</p>
 
 <p class="note"><strong>Note:</strong> You may find information on implementing accessibility for
@@ -525,50 +548,141 @@ approach is to use the
 methods.</p>
 
 
+<h3 id="virtual-hierarchy">Providing a customized accessibility context</h3>
+
+<p>In Android 4.0 (API Level 14), the framework was enhanced to allow accessibility services to
+  inspect the containing view hierarchy of a user interface component that generates an
+  accessibility event. This enhancement allows accessibility services to provide a much richer set
+  of contextual information with which to aid users.</p>
+
+<p>There are some cases where accessibility services cannot get adequate information
+  from the view hierarchy. An example of this is a custom interface control that has two or more
+  separately clickable areas, such as a calendar control. In this case, the services cannot get
+  adequate information because the clickable subsections are not part of the view hierarchy.</p>
+
+<img src="calendar.png" alt="" id="figure1" />
+<p class="img-caption">
+  <strong>Figure 1.</strong> A custom calendar view with selectable day elements.
+</p>
+
+<p>In the example shown in Figure 1, the entire calendar is implemented as a single view, so if you
+  do not do anything else, accessibility services do not receive enough information about the
+  content of the view and the user's selection within the view. For example, if a user clicks on the
+  day containing <strong>17</strong>, the accessibility framework only receives the description
+  information for the whole calendar control. In this case, the TalkBack accessibility service would
+  simply announce "Calendar" or, only slightly better, "April Calendar" and the user would be left
+  to wonder what day was selected.</p>
+
+<p>To provide adequate context information for accessibility services in situations like this,
+  the framework provides a way to specify a virtual view hierarchy. A <em>virtual view
+  hierarchy</em> is a way for application developers to provide a complementary view hierarchy
+  to accessibility services that more closely matches the actual information on screen. This
+  approach allows accessibility services to provide more useful context information to users.</p>
+
+<p>Another situation where a virtual view hierarchy may be needed is a user interface containing
+  a set of controls (views) that have closely related functions, where an action on one control
+  affects the contents of one or more elements, such as a number picker with separate up and down
+  buttons. In this case, accessibility services cannot get adequate information because action on
+  one control changes content in another and the relationship of those controls may not be apparent
+  to the service. To handle this situation, group the related controls with a containing view and
+  provide a virtual view hierarchy from this container to clearly represent the information and
+  behavior provided by the controls.</p>
+
+<p>In order to provide a virtual view hierarchy for a view, override the {@link
+  android.view.View#getAccessibilityNodeProvider} method in your custom view or view group and
+  return an implementation of {@link android.view.accessibility.AccessibilityNodeProvider}. For an
+  example implementation of this accessibility feature, see
+  {@code AccessibilityNodeProviderActivity} in the ApiDemos sample project. You can implement a
+  virtual view hierarchy that is compatible with Android 1.6 and later by using the
+  <a href="{@docRoot}tools/extras/support-library.html">Support Library</a> with the
+  {@link android.support.v4.view.ViewCompat#getAccessibilityNodeProvider
+  ViewCompat.getAccessibilityNodeProvider()} method and providing an implementation with
+  {@link android.support.v4.view.accessibility.AccessibilityNodeProviderCompat}.</p>
+
+
+<h3 id="custom-touch-events">Handling custom touch events</h3>
+
+<p>Custom view controls may require non-standard touch event behavior. For example, a custom
+control may use the {@link android.view.View#onTouchEvent} listener method to detect the
+{@link android.view.MotionEvent#ACTION_DOWN} and {@link android.view.MotionEvent#ACTION_UP} events
+and trigger a special click event. In order to maintain compatibility with accessibility services,
+the code that handles this custom click event must do the following:</p>
+
+<ol>
+  <li>Generate an appropriate {@link android.view.accessibility.AccessibilityEvent} for the
+  interpreted click action.</li>
+  <li>Enable accessibility services to perform the custom click action for users who are not able to
+   use a touch screen.</li>
+</ol>
+
+<p>To handle these requirements in an efficient way, your code should override the
+{@link android.view.View#performClick} method, which must call the super implementation of this
+method and then execute whatever actions are required by the click event. When the custom click
+action is detected, that code should then call your {@code performClick()} method. The following
+code example demonstrates this pattern.</p>
+
+<pre>
+class CustomTouchView extends View {
+
+    public CustomTouchView(Context context) {
+        super(context);
+    }
+
+    boolean mDownTouch = false;
+
+    &#64;Override
+    public boolean onTouchEvent(MotionEvent event) {
+        super.onTouchEvent(event);
+
+        // Listening for the down and up touch events
+        switch (event.getAction()) {
+            case MotionEvent.ACTION_DOWN:
+                mDownTouch = true;
+                return true;
+
+            case MotionEvent.ACTION_UP:
+                if (mDownTouch) {
+                    mDownTouch = false;
+                    performClick(); // Call this method to handle the response, and
+                                    // thereby enable accessibility services to
+                                    // perform this action for a user who cannot
+                                    // click the touchscreen.
+                    return true;
+                }
+        }
+        return false; // Return false for other touch events
+    }
+
+    &#64;Override
+    public boolean performClick() {
+        // Calls the super implementation, which generates an AccessibilityEvent
+        // and calls the onClick() listener on the view, if any
+        super.performClick();
+
+        // Handle the action for the custom click here
+
+        return true;
+    }
+}
+</pre>
+
+<p>The pattern shown above makes sure that the custom click event is compatible with
+accessibility services by using the {@link android.view.View#performClick} method to both generate
+an accessibility event and provide an entry point for accessibility services to act on behalf of a
+user to perform this custom click event.</p>
+
+<p class="note"><strong>Note:</strong> If your custom view has distinct clickable regions, such as
+a custom calendar view, you must implement a <a href="#virtual-hierarchy">virtual view
+hierarchy</a> by overriding {@link android.view.View#getAccessibilityNodeProvider} in your custom
+view in order to be compatible with accessibility services.</p>
+
+
 <h2 id="test">Testing Accessibility</h2>
 
 <p>Testing the accessibility of your application is an important part of ensuring your users have a
-great experience. You can test the most important parts of accessibility by testing your application
-with audible feedback enabled and testing navigation within your application using directional
-controls.</p>
+great experience. You can test the most important accessibility features by using your application
+with audible feedback enabled and navigating within your application using only directional
+controls. For more information on testing accessibility in your application, see the
+<a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing Checklist</a>.
+</p>
 
-<h3 id="test-audibles">Testing audible feedback</h3>
-<p>You can simulate the experience for many users by enabling an accessibility service that speaks
-as you move around the screen. The Explore by Touch accessibility service, which is available on
-devices with Android 4.0 and later. The <a
-href="https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback">TalkBack</a>
-accessibility service, by the <a href="http://code.google.com/p/eyes-free/">Eyes-Free
-Project</a> comes preinstalled on many Android devices.</p>
-
-<p>To enable TalkBack on revisions of Android prior to Android 4.0:</p>
-<ol>
-  <li>Launch the Settings application.</li>
-  <li>Navigate to the <strong>Accessibility</strong> category and select it.</li>
-  <li>Select <strong>Accessibility</strong> to enable it.</li>
-  <li>Select <strong>TalkBack</strong> to enable it.</li>
-</ol>
-
-<p class="note"><strong>Note:</strong> If the TalkBack accessibility service is not available, you
-can install it for free from <a href="http://play.google.com">Google Play</a>.</p>
-
-<p>To enable Explore by Touch on Android 4.0 and later:</p>
-<ol>
-  <li>Launch the Settings application.</li>
-  <li>Navigate to the <strong>Accessibility</strong> category and select it.</li>
-  <li>Select the <strong>TalkBack</strong> to enable it.</li>
-  <li>Return to the <strong>Accessibility</strong> category and select <strong>Explore by
-Touch</strong> to enable it.
-    <p class="note"><strong>Note:</strong> You must turn on TalkBack <em>first</em>, otherwise this
-option is not available.</p>
-  </li>
-</ol>
-
-<h3 id="test-navigation">Testing focus navigation</h3>
-
-<p>As part of your accessibility testing, you can test navigation of your application using focus,
-even if your test devices does not have a directional controller. The <a
-href="{@docRoot}tools/help/emulator.html">Android Emulator</a> provides a
-simulated directional controller that you can easily use to test navigation. You can also use a
-software-based directional controller, such as the one provided by the
-<a href="https://play.google.com/store/apps/details?id=com.googlecode.eyesfree.inputmethod.latin">
-Eyes-Free Keyboard</a> to simulate use of a D-pad.</p>
diff --git a/docs/html/guide/topics/ui/accessibility/calendar.png b/docs/html/guide/topics/ui/accessibility/calendar.png
new file mode 100644
index 0000000000000000000000000000000000000000..ca5c44f6437cca28e542be4299e1ed30fe35e75d
GIT binary patch
literal 17811
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
SC%>u!xvim#D86Cy=>Gx0OoQV9

literal 0
HcmV?d00001

diff --git a/docs/html/guide/topics/ui/accessibility/checklist.jd b/docs/html/guide/topics/ui/accessibility/checklist.jd
new file mode 100644
index 0000000000000..9473d1bd3f9df
--- /dev/null
+++ b/docs/html/guide/topics/ui/accessibility/checklist.jd
@@ -0,0 +1,173 @@
+page.title=Accessibility Developer Checklist
+parent.title=Accessibility
+parent.link=index.html
+@jd:body
+
+<div id="qv-wrapper">
+<div id="qv">
+
+  <h2>In this document</h2>
+  <ol>
+    <li><a href="#requirements">Accessibility Requirements</a></li>
+    <li><a href="#recommendations">Accessibility Recommendations</a></li>
+    <li><a href="#special-cases">Special Cases and Considerations</a></li>
+  </ol>
+
+  <h2>See also</h2>
+  <ol>
+    <li><a href="{@docRoot}design/patterns/accessibility.html">Android Design: Accessibility</a></li>
+    <li><a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing Checklist</a></li>
+    <li><a href="{@docRoot}training/accessibility/index.html">Training: Implementing Accessibility</a></li>
+    <li><a href="{@docRoot}training/design-navigation/index.html">Designing Effective Navigation</a></li>
+  </ol>
+
+</div>
+</div>
+
+<p>Making an application accessible is about a deep commitment to usability, getting the
+details right and delighting your users. This document provides a checklist of accessibility
+requirements, recommendations and considerations to help you make sure your application is
+accessible. Following this checklist does not guarantee your application is accessible, but it's a
+good place to start.</p>
+
+<p>Creating an accessible application is not just the responsibility of developers. Involve your
+design and testing folks as well, and make them are aware of the guidelines for these other stages
+of development:</p>
+
+<ul>
+  <li><a href="{@docRoot}design/patterns/accessibility.html">Android Design: Accessibility</a></li>
+  <li><a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing
+    Checklist</a></li>
+</ul>
+
+<p>In most cases, creating an accessible Android application does not require extensive code
+restructuring. Rather, it means working through the subtle details of how users interact with your
+application, so you can provide them with feedback they can sense and understand. This checklist
+helps you focus on the key development issues to get the details of accessibility right.</p>
+
+
+<h2 id="requirements">Accessibility Requirements</h2>
+
+<p>The following steps must be completed in order to ensure a minimum level of application
+  accessibility.</p>
+
+<ol>
+  <li><strong>Describe user interface controls:</strong> Provide content
+    <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#label-ui">descriptions</a> for user
+    interface components that do not have visible text, particularly
+    {@link android.widget.ImageButton}, {@link android.widget.ImageView}
+    and {@link android.widget.CheckBox} components. Use the
+    <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
+    {@code android:contentDescription}</a> XML layout attribute or the {@link
+    android.view.View#setContentDescription} method to provide this information for accessibility
+    services. (Exception: <a href="#decorative">decorative graphics</a>)</li>
+  <li><strong>Enable focus-based navigation:</strong> Make sure
+    <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#focus-nav">users can navigate</a>
+    your screen layouts using hardware-based or software directional controls (D-pads, trackballs,
+    keyboards and navigation gestures). In a few cases, you may need to make user interface components
+    <a href="{@docRoot}reference/android/view/View.html#attr_android:focusable">focusable</a>
+    or change the <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#focus-order">focus
+    order</a> to be more logical for user actions.</li>
+  <li><strong>Custom view controls:</strong> If you build
+    <a href="{@docRoot}guide/topics/ui/custom-components.html">custom interface controls</a> for
+    your application, <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#custom-views">
+    implement accessibility interfaces</a> for your custom views and provide content descriptions.
+    For custom controls that are intended to be compatible with versions of Android back to 1.6,
+    use the <a href="{@docRoot}tools/extras/support-library.html">Support Library</a> to implement
+    the latest accessibility features.</li>
+  <li><strong>No audio-only feedback:</strong> Audio feedback must always have a secondary
+    feedback mechanism to support users who are deaf or hard of hearing. For example, a sound alert
+    for the arrival of a message must be accompanied by a system
+    {@link android.app.Notification}, haptic feedback (if available) or other visual alert.</li>
+  <li><strong>Test:</strong> Test accessibility by navigating your application
+    using directional controls, and using eyes-free navigation with TalkBack enabled.
+    For more accessibility testing information, see the
+    <a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing
+    Checklist</a>.</li>
+</ol>
+
+
+<h2 id="recommendations">Accessibility Recommendations</h2>
+
+<p>The following steps are recommended for ensuring the accessibility of your application. If you
+  do not take these actions, it may impact the overall accessibility and quality of your
+  application.</p>
+
+<ol>
+  <li><strong>Android Design Accessibility Guidelines:</strong> Before building your layouts,
+    review and follow the accessibility guidelines provided in the
+    <a href="{@docRoot}design/patterns/accessibility.html">Design guidelines</a>.</li>
+  <li><strong>Framework-provided controls:</strong> Use Android's built-in user interface
+    controls whenever possible, as these components provide accessibility support by default.</li>
+  <li><strong>Temporary or self-hiding controls and notifications:</strong> Avoid having user
+    interface controls that fade out or disappear after a certain amount of time. If this behavior
+    is important to your application, provide an alternative interface for these functions.</li>
+</ol>
+
+
+<h2 id="special-cases">Special Cases and Considerations</h2>
+
+<p>The following list describes specific situations where action should be taken to ensure an
+  accessible app. Review this list to see if any of these special cases and considerations apply to
+  your application, and take the appropriate action.</p>
+
+<ol>
+  <li><strong>Text field hints:</strong> For {@link android.widget.EditText} fields, provide an
+    <a href="{@docRoot}reference/android/widget/TextView.html#attr_android:hint">android:hint</a>
+    attribute <em>instead</em> of a content description, to help users understand what content is
+    expected when the text field is empty and allow the contents of the field to be spoken when
+    it is filled.</li>
+  <li><strong>Custom controls with high visual context:</strong> If your application contains a
+    <a href="{@docRoot}guide/topics/ui/custom-components.html">custom control</a> with a high degree
+    of visual context (such as a calendar control), default accessibility services processing may
+    not provide adequate descriptions for users, and you should consider providing a
+    <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#virtual-hierarchy">virtual
+    view hierarchy</a> for your control using
+    {@link android.view.accessibility.AccessibilityNodeProvider}.</li>
+  <li><strong>Custom controls and click handling:</strong> If a custom control in your
+    application performs specific handling of user touch interaction, such as listening with
+    {@link android.view.View#onTouchEvent} for {@link android.view.MotionEvent#ACTION_DOWN
+    MotionEvent.ACTION_DOWN} and {@link android.view.MotionEvent#ACTION_UP MotionEvent.ACTION_UP}
+    and treating it as a click event, you must trigger an {@link
+    android.view.accessibility.AccessibilityEvent} equivalent to a click and provide a way for
+    accessibility services to perform this action for users. For more information, see
+    <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#custom-touch-events">Handling custom
+    touch events</a>.</li>
+  <li><strong>Controls that change function:</strong> If you have buttons or other controls
+    that change function during the normal activity of a user in your application (for example, a
+    button that changes from <strong>Play</strong> to <strong>Pause</strong>), make sure you also
+    change the <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">
+    {@code android:contentDescription}</a> of the button appropriately.</li>
+  <li><strong>Prompts for related controls:</strong> Make sure sets of controls which provide a
+    single function, such as the {@link android.widget.DatePicker}, provide useful audio feedback
+    when an user interacts with the individual controls.</li>
+  <li><strong>Video playback and captioning:</strong> If your application provides video
+    playback, it must support captioning and subtitles to assist users who are deaf or hard of
+    hearing. Your video playback controls must also clearly indicate if captioning is available for
+    a video and provide a clear way of enabling captions.</li>
+  <li><strong>Supplemental accessibility audio feedback:</strong> Use only the Android accessibility
+    framework to provide accessibility audio feedback for your app. Accessibility services such as
+    <a href="https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback"
+    >TalkBack</a> should be the only way your application provides accessibility audio prompts to
+    users. Provide the prompting information with a
+    <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">{@code
+    android:contentDescription}</a> XML layout attribute or dynamically add it using accessibility
+    framework APIs. For example, if your application takes action that you want to announce to a
+    user, such as automatically turning the page of a book, use the {@link
+    android.view.View#announceForAccessibility} method to have accessibility services speak this
+    information to the user.</li>
+  <li><strong>Custom controls with complex visual interactions:</strong> For custom controls that
+    provide complex or non-standard visual interactions, provide a
+    <a href="{@docRoot}guide/topics/ui/accessibility/apps.html#virtual-hierarchy">virtual view
+    hierarchy</a> for your control using {@link android.view.accessibility.AccessibilityNodeProvider}
+    that allows accessibility services to provide a simplified interaction model for the user. If
+    this approach is not feasible, consider providing an alternate view that is accessible.</li>
+  <li><strong>Sets of small controls:</strong> If you have controls that are smaller than
+    the minimum recommended touch size in your application screens, consider grouping these controls
+    together using a {@link android.view.ViewGroup} and providing a
+    <a href="{@docRoot}reference/android/view/View.html#attr_android:contentDescription">{@code
+    android:contentDescription}</a> for the group.</li>
+  <li id="decorative"><strong>Decorative images and graphics:</strong> Elements in application
+    screens that are purely decorative and do not provide any content or enable a user action should
+    not have accessibility content descriptions.</li>
+</ol>
diff --git a/docs/html/guide/topics/ui/accessibility/index.jd b/docs/html/guide/topics/ui/accessibility/index.jd
index 6fd71e2c9ad7d..6cdbde4e5cf74 100644
--- a/docs/html/guide/topics/ui/accessibility/index.jd
+++ b/docs/html/guide/topics/ui/accessibility/index.jd
@@ -8,47 +8,67 @@ parent.link=../index.html
 
   <h2>Topics</h2>
   <ol>
-  <li><a href="{@docRoot}guide/topics/ui/accessibility/apps.html">Making Applications Accessible</a>
-    </li>
-  <li><a href="{@docRoot}guide/topics/ui/accessibility/services.html">Building Accessibility
-    Services</a></li>
+  <li><a href="apps.html">
+    Making Applications Accessible</a></li>
+  <li><a href="checklist.html">
+    Accessibility Developer Checklist</a></li>
+  <li><a href="services.html">
+    Building Accessibility Services</a></li>
   </ol>
 
-  <h2>Key classes</h2>
-  <ol>
-    <li>{@link android.view.accessibility.AccessibilityEvent}</li>
-    <li>{@link android.accessibilityservice.AccessibilityService}</li>
-  </ol>
-  
   <h2>See also</h2>
   <ol>
-    <li><a href="{@docRoot}training/accessibility/index.html">Implementing Accessibility</a></li>
+    <li><a href="{@docRoot}design/patterns/accessibility.html">Android Design: Accessibility</a></li>
+    <li><a href="{@docRoot}training/accessibility/index.html">Training: Implementing Accessibility</a></li>
+    <li><a href="{@docRoot}tools/testing/testing_accessibility.html">Accessibility Testing Checklist</a></li>
+  </ol>
+
+  <h2>Related Videos</h2>
+  <ol>
+    <li>
+      <iframe title="Google I/O 2012 - Making Android Apps Accessible"
+          width="210" height="160"
+          src="http://www.youtube.com/embed/q3HliaMjL38?rel=0&amp;hd=1"
+          frameborder="0" allowfullscreen>
+      </iframe>
+    <li>
   </ol>
 
 </div>
 </div>
 
-<p>Many Android users have disabilities that require them to interact with their Android devices in
-different ways. These include users who have visual, physical or age-related disabilities that
-prevent them from fully seeing or using a touchscreen.</p>
+<p>Many Android users have different abilities that require them to interact with their Android
+devices in different ways. These include users who have visual, physical or age-related limitations
+that prevent them from fully seeing or using a touchscreen, and users with hearing loss who may not
+be able to perceive audible information and alerts.</p>
 
 <p>Android provides accessibility features and services for helping these users navigate their
-devices more easily, including text-to-speech, haptic feedback, trackball and D-pad navigation that
-augment their experience. Android application developers can take advantage of these services to
-make their applications more accessible and also build their own accessibility services.</p>
+devices more easily, including text-to-speech, haptic feedback, gesture navigation, trackball and
+directional-pad navigation. Android application developers can take advantage of these services to
+make their applications more accessible.</p>
+
+<p>Android developers can also build their own accessibility services, which can provide
+enhanced usability features such as audio prompting, physical feedback, and alternative navigation
+modes. Accessibility services can provide these enhancements for all applications, a set of
+applications or just a single app.</p>
 
 <p>The following topics show you how to use the Android framework to make applications more
 accessible.</p>
 
 <dl>
-  <dt><strong><a href="{@docRoot}guide/topics/ui/accessibility/apps.html">Making Applications
-Accessible</a></strong>
+  <dt><strong><a href="{@docRoot}guide/topics/ui/accessibility/apps.html">
+  Making Applications Accessible</a></strong>
   </dt>
   <dd>Development practices and API features to ensure your application is accessible to users with
 disabilities.</dd>
 
-  <dt><strong><a href="{@docRoot}guide/topics/ui/accessibility/services.html">Building Accessibility
-Services</a></strong>
+  <dt><strong><a href="{@docRoot}guide/topics/ui/accessibility/checklist.html">
+  Accessibility Developer Checklist</a></strong>
+  </dt>
+  <dd>A checklist to help developers ensure that their applications are accessible.</dd>
+
+  <dt><strong><a href="{@docRoot}guide/topics/ui/accessibility/services.html">
+  Building Accessibility Services</a></strong>
   </dt>
   <dd>How to use API features to build services that make other applications more accessible for
 users.</dd>
diff --git a/docs/html/guide/topics/ui/accessibility/services.jd b/docs/html/guide/topics/ui/accessibility/services.jd
index 7d36181941c4a..2a6fe7ab802de 100644
--- a/docs/html/guide/topics/ui/accessibility/services.jd
+++ b/docs/html/guide/topics/ui/accessibility/services.jd
@@ -14,8 +14,16 @@ parent.link=index.html
         <li><a href="#service-config">Accessibility service configuration</a></li>
       </ol>
     </li>
+    <li><a href="#register">Registering for Accessibility Events</a></li>
     <li><a href="#methods">AccessibilityService Methods</a></li>
     <li><a href="#event-details">Getting Event Details</a></li>
+    <li><a href="#act-for-users">Taking Action for Users</a>
+      <ol>
+        <li><a href="#detect-gestures">Listening for gestures</a></li>
+        <li><a href="#using-actions">Using accessibility actions</a></li>
+        <li><a href="#focus-types">Using focus types</a></li>
+      </ol>
+    </li>
     <li><a href="#examples">Example Code</a></li>
   </ol>
 
@@ -30,7 +38,7 @@ parent.link=index.html
 
   <h2>See also</h2>
   <ol>
-    <li><a href="{@docRoot}training/accessibility/index.html">Implementing Accessibility</a></li>
+    <li><a href="{@docRoot}training/accessibility/index.html">Training: Implementing Accessibility</a></li>
   </ol>
 
 </div>
@@ -45,20 +53,20 @@ might need additional or alternative interface feedback.</p>
 create and distribute their own services. This document explains the basics of building an
 accessibility service.</p>
 
-<p>The ability for you to build and deploy accessibility services was introduced with Android
-1.6 (API Level 4) and received significant improvements with Android 4.0 (API Level 14). The Android
-Support Library was also updated with the release of Android 4.0 to provide support for these
-enhanced accessibility features back to Android 1.6. Developers aiming for widely compatible
-accessibility services are encouraged to use the
-<a href="{@docRoot}tools/extras/support-library.html">Support Library</a> and develop for the more
-advanced accessibility features introduced in Android 4.0.</p>
+<p>The ability for you to build and deploy accessibility services was introduced with Android 1.6
+  (API Level 4) and received significant improvements with Android 4.0 (API Level 14). The Android
+  <a href="{@docRoot}tools/extras/support-library.html">Support Library</a> was also updated with
+  the release of Android 4.0 to provide support for these enhanced accessibility features back to
+  Android 1.6. Developers aiming for widely compatible accessibility services are encouraged to use
+  the Support Library and develop for the more advanced accessibility features introduced in
+  Android 4.0.</p>
 
 
 <h2 id="manifest">Manifest Declarations and Permissions</h2>
 
 <p>Applications that provide accessibility services must include specific declarations in their
- application manifests in order to be treated as an accessibility service by an Android system.
- This section explains the required and optional settings for accessibility services.</p>
+ application manifests to be treated as an accessibility service by the Android system. This
+ section explains the required and optional settings for accessibility services.</p>
 
 
 <h3 id="service-declaration">Accessibility service declaration</h3>
@@ -66,7 +74,9 @@ advanced accessibility features introduced in Android 4.0.</p>
 <p>In order to be treated as an accessibility service, your application must include the
 {@code service} element (rather than the {@code activity} element) within the {@code application}
 element in its manifest. In addition, within the {@code service} element, you must also include an
-accessibility service intent filter, as shown in the following sample:</p>
+accessibility service intent filter. For compatiblity with Android 4.1 and higher, the manifest
+must also request the {@link android.Manifest.permission#BIND_ACCESSIBILITY_SERVICE} permission
+as shown in the following sample:</p>
 
 <pre>
 &lt;application&gt;
@@ -76,6 +86,7 @@ accessibility service intent filter, as shown in the following sample:</p>
       &lt;action android:name=&quot;android.accessibilityservice.AccessibilityService&quot; /&gt;
     &lt;/intent-filter&gt;
   &lt;/service&gt;
+  &lt;uses-permission android:name="android.permission.BIND_ACCESSIBILITY_SERVICE" /&gt;
 &lt;/application&gt;
 </pre>
 
@@ -123,27 +134,6 @@ shows example contents for the service configuration file:</p>
 /&gt;
 </pre>
 
-<p>One of the most important functions of the accessibility service configuration parameters is to
-allow you to specify what types of accessibility events your service can handle. Being able to
-specify this information enables accessibility services to cooperate with each other, and allows you
-as a developer the flexibility to handle only specific events types from specific applications. The
-event filtering can include the following criteria:</p>
-
-<ul>
-  <li><strong>Package Names</strong> - Specify the package names of applications whose accessibility
-events you want your service to handle. If this parameter is omitted, your accessibility service is
-considered available to service accessibility events for any application. This parameter can be set
-in the accessibility service configuration files with the {@code android:packageNames} attribute as
-a comma-separated list, or set using the {@link
-android.accessibilityservice.AccessibilityServiceInfo#packageNames
-AccessibilityServiceInfo.packageNames} member.</li>
-  <li><strong>Event Types</strong> - Specify the types of accessibility events you want your service
-to handle. This parameter can be set in the accessibility service configuration files with the
-{@code android:accessibilityEventTypes} attribute as a comma-separated list, or set using the
-{@link android.accessibilityservice.AccessibilityServiceInfo#eventTypes
-AccessibilityServiceInfo.eventTypes} member. </li>
-</ul>
-
 <p>For more information about the XML attributes which can be used in the accessibility service
  configuration file, follow these links to the reference documentation:</p>
 
@@ -162,9 +152,45 @@ AccessibilityServiceInfo.eventTypes} member. </li>
 the {@link android.accessibilityservice.AccessibilityServiceInfo} reference documentation.</p>
 
 
+<h2 id="register">Registering for Accessibility Events</h2>
+
+<p>One of the most important functions of the accessibility service configuration parameters is to
+allow you to specify what types of accessibility events your service can handle. Being able to
+specify this information enables accessibility services to cooperate with each other, and allows you
+as a developer the flexibility to handle only specific events types from specific applications. The
+event filtering can include the following criteria:</p>
+
+<ul>
+  <li><strong>Package Names</strong> - Specify the package names of applications whose accessibility
+events you want your service to handle. If this parameter is omitted, your accessibility service is
+considered available to service accessibility events for any application. This parameter can be set
+in the accessibility service configuration files with the {@code android:packageNames} attribute as
+a comma-separated list, or set using the {@link
+android.accessibilityservice.AccessibilityServiceInfo#packageNames
+AccessibilityServiceInfo.packageNames} member.</li>
+  <li><strong>Event Types</strong> - Specify the types of accessibility events you want your service
+to handle. This parameter can be set in the accessibility service configuration files with the
+{@code android:accessibilityEventTypes} attribute as a list separated by the {@code |} character
+(for example {@code accessibilityEventTypes="typeViewClicked|typeViewFocused"}), or set using the
+{@link android.accessibilityservice.AccessibilityServiceInfo#eventTypes
+AccessibilityServiceInfo.eventTypes} member. </li>
+</ul>
+
+<p>When setting up your accessibility service, carefully consider what events your service is able
+to handle and only register for those events. Since users can activate more than one accessibility
+services at a time, your service must not consume events that it is not able to handle. Remember
+that other services may handle those events in order to improve a user's experience.</p>
+
+<p class="note"><strong>Note:</strong> The Android framework dispatches accessibility events to
+more than one accessibility service if the services provide different
+<a href="{@docRoot}reference/android/R.styleable.html#AccessibilityService_accessibilityFeedbackType">
+feedback types</a>. However, if two or more services provide the same feedback type, then only the
+first registered service receives the event.</p>
+
+
 <h2 id="methods">AccessibilityService Methods</h2>
 
-<p>An application that provides accessibility service must extend the {@link
+<p>An accessibility service must extend the {@link
 android.accessibilityservice.AccessibilityService} class and override the following methods from
 that class. These methods are presented in the order in which they are called by the Android system,
 from when the service is started
@@ -188,15 +214,15 @@ onAccessibilityEvent()} - (required) This method is called back by the system wh
 {@link android.view.accessibility.AccessibilityEvent} that matches the event filtering parameters
 specified by your accessibility service. For example, when the user clicks a button or focuses on a
 user interface control in an application for which your accessibility service is providing feedback.
-When this happens, the system calls this method of your service with the associated {@link
-android.view.accessibility.AccessibilityEvent}, which you can then interpret and provide feedback to
-the user. This method may be called many times over the lifecycle of your service.</li>
+When this happens, the system calls this method, passing the associated {@link
+android.view.accessibility.AccessibilityEvent}, which the service can then interpret and use to
+provide feedback to the user. This method may be called many times over the lifecycle of your
+service.</li>
 
   <li>{@link android.accessibilityservice.AccessibilityService#onInterrupt onInterrupt()} -
 (required) This method is called when the system wants to interrupt the feedback your service is
-providing, usually in response to a user taking action, such as moving focus to a different user
-interface control than the one for which you are currently providing feedback. This method may be
-called many times over the lifecycle of your service.</li>
+providing, usually in response to a user action such as moving focus to a different control. This
+method may be called many times over the lifecycle of your service.</li>
 
   <li>{@link android.accessibilityservice.AccessibilityService#onUnbind onUnbind()} - (optional)
 This method is called when the system is about to shutdown the accessibility service. Use this
@@ -206,7 +232,9 @@ services, such as the audio manager or device vibrator.</li>
 
 <p>These callback methods provide the basic structure for your accessibility service. It is up to
 you to decide on how to process data provided by the Android system in the form of {@link
-android.view.accessibility.AccessibilityEvent} objects and provide feedback to the user.</p>
+android.view.accessibility.AccessibilityEvent} objects and provide feedback to the user. For more
+information about getting information from an accessibility event, see the
+<a href="{@docRoot}training/accessibility/service.html">Implementing Accessibility</a> training.</p>
 
 
 <h2 id="event-details">Getting Event Details</h2>
@@ -214,15 +242,15 @@ android.view.accessibility.AccessibilityEvent} objects and provide feedback to t
 <p>The Android system provides information to accessibility services about the user interface
 interaction through {@link android.view.accessibility.AccessibilityEvent} objects. Prior to Android
 4.0, the information available in an accessibility event, while providing a significant amount of
-detail about a user interface control selected by the user, typically provided limited contextual
+detail about a user interface control selected by the user, offered limited contextual
 information. In many cases, this missing context information might be critical to understanding the
 meaning of the selected control.</p>
 
-<p>A typical example of an interface where context is of critical importance is a calendar or day
-planner. If a user selects a 4:00 PM time slot in a Monday to Friday day list and the accessibility
-service announces “4 PM”, but fails to indicate this is a Friday a Monday, the month or day, this is
-hardly ideal feedback for the user. In this case, the context of a user interface control is of
-critical importance to a user who wants to schedule a meeting.</p>
+<p>An example of an interface where context is critical is a calendar or day planner. If the
+user selects a 4:00 PM time slot in a Monday to Friday day list and the accessibility service
+announces “4 PM”, but does not announce the weekday name, the day of the month, or the month name,
+the resulting feedback is confusing. In this case, the context of a user interface control is
+critical to a user who wants to schedule a meeting.</p>
 
 <p>Android 4.0 significantly extends the amount of information that an accessibility service can
 obtain about an user interface interaction by composing accessibility events based on the view
@@ -245,26 +273,167 @@ can obtain additional information about the event using these calls:</p>
 AccessibilityEvent.getRecordCount()} and {@link
 android.view.accessibility.AccessibilityEvent#getRecord getRecord(int)} - These methods allow you to
 retrieve the set of {@link android.view.accessibility.AccessibilityRecord} objects which contributed
-to the {@link android.view.accessibility.AccessibilityEvent} passed to you by the system, which can
-provide more context for your accessibility service.</li>
+to the {@link android.view.accessibility.AccessibilityEvent} passed to you by the system. This level
+of detail provides more context for the event that triggered your accessibility service.</li>
 
   <li>{@link android.view.accessibility.AccessibilityEvent#getSource
 AccessibilityEvent.getSource()} - This method returns an {@link
-android.view.accessibility.AccessibilityNodeInfo} object. This object allows you to request the
-parents and children of the component that originated the accessibility event and investigate their
-contents and state in order to provide
+android.view.accessibility.AccessibilityNodeInfo} object. This object allows you to request view
+layout hierarchy (parents and children) of the component that originated the accessibility event.
+This feature allows an accessibility service to investigate the full context of an event, including
+the content and state of any enclosing views or child views.
 
-    <p class="caution"><strong>Important:</strong> The ability to investigate the full view
+<p class="caution"><strong>Important:</strong> The ability to investigate the view
 hierarchy from an {@link android.view.accessibility.AccessibilityEvent} potentially exposes private
 user information to your accessibility service. For this reason, your service must request this
 level of access through the accessibility <a href="#service-config">service configuration XML</a>
 file, by including the {@code canRetrieveWindowContent} attribute and setting it to {@code true}. If
 you do not include this setting in your service configuration xml file, calls to {@link
 android.view.accessibility.AccessibilityEvent#getSource getSource()} fail.</p>
+
+<p class="note"><strong>Note:</strong> In Android 4.1 (API Level 16) and higher, the
+{@link android.view.accessibility.AccessibilityEvent#getSource getSource()} method,
+as well as {@link android.view.accessibility.AccessibilityNodeInfo#getChild
+AccessibilityNodeInfo.getChild()} and
+{@link android.view.accessibility.AccessibilityNodeInfo#getParent getParent()}, return only
+view objects that are considered important for accessibility (views that draw content or respond to
+user actions). If your service requires all views, it can request them by setting the
+{@link android.accessibilityservice.AccessibilityServiceInfo#flags flags} member of the service's
+{@link android.accessibilityservice.AccessibilityServiceInfo} instance to
+{@link android.accessibilityservice.AccessibilityServiceInfo#FLAG_INCLUDE_NOT_IMPORTANT_VIEWS}.</p>
   </li>
 </ul>
 
 
+<h2 id="act-for-users">Taking Action for Users</h2>
+
+<p>Starting with Android 4.0 (API Level 14), accessibility services can act on behalf
+  of users, including changing the input focus and selecting (activating) user interface elements.
+  In Android 4.1 (API Level 16) the range of actions has been expanded to include scrolling lists
+  and interacting with text fields. Accessibility services can
+  also take global actions, such as navigating to the Home screen, pressing the Back button, opening
+  the notifications screen and recent applications list. Android 4.1 also includes a new type of
+  focus, <em>Accessibilty Focus</em>, which makes all visible elements selectable by an
+  accessibility service.</p>
+
+<p>These new capabilities make it possible for developers of accessibility services to create
+  alternative navigation modes such as
+  <a href="{@docRoot}tools/testing/testing_accessibility.html#test-gestures">gesture navigation</a>,
+  and give users with disabilities improved control of their Android devices.</p>
+
+
+<h3 id="detect-gestures">Listening for gestures</h3>
+
+<p>Accessibility services can listen for specific gestures and respond by taking action on behalf
+  of a user. This feature, added in Android 4.1 (API Level 16), and requires that your
+  accessibility service request activation of the Explore by Touch feature. Your service can
+  request this activation by setting the
+  {@link android.accessibilityservice.AccessibilityServiceInfo#flags flags} member of the service’s
+  {@link android.accessibilityservice.AccessibilityServiceInfo} instance to
+  {@link android.accessibilityservice.AccessibilityServiceInfo#FLAG_REQUEST_TOUCH_EXPLORATION_MODE},
+  as shown in the following example.
+  </p>
+
+<pre>
+public class MyAccessibilityService extends AccessibilityService {
+    &#64;Override
+    public void onCreate() {
+        getServiceInfo().flags = AccessibilityServiceInfo.FLAG_REQUEST_TOUCH_EXPLORATION_MODE;
+    }
+    ...
+}
+</pre>
+
+<p>Once your service has requested activation of Explore by Touch, the user must allow the
+  feature to be turned on, if it is not already active. When this feature is active, your service
+  receives notification of accessibility gestures through your service's
+  {@link android.accessibilityservice.AccessibilityService#onGesture onGesture()} callback method
+  and can respond by taking actions for the user.</p>
+
+
+<h3 id="using-actions">Using accessibility actions</h3>
+
+<p>Accessibility services can take action on behalf of users to make interacting with applications
+  simpler and more productive. The ability of accessibility services to perform actions was added
+  in Android 4.0 (API Level 14) and significantly expanded with Android 4.1 (API Level 16).</p>
+
+<p>In order to take actions on behalf of users, your accessibility service must
+  <a href="#register">register</a> to receive events from a few or many applications and request
+  permission to view the content of applications by setting the
+  <a href="{@docRoot}reference/android/R.styleable.html#AccessibilityService_canRetrieveWindowContent">
+  {@code android:canRetrieveWindowContent}</a> to {@code true} in the
+  <a href="#service-config">service configuration file</a>. When events are received by your
+  service, it can then retrieve the
+  {@link android.view.accessibility.AccessibilityNodeInfo} object from the event using
+  {@link android.view.accessibility.AccessibilityEvent#getSource getSource()}.
+  With the {@link android.view.accessibility.AccessibilityNodeInfo} object, your service can then
+  explore the view hierarchy to determine what action to take and then act for the user using
+  {@link android.view.accessibility.AccessibilityNodeInfo#performAction performAction()}.</p>
+
+<pre>
+public class MyAccessibilityService extends AccessibilityService {
+
+    &#64;Override
+    public void onAccessibilityEvent(AccessibilityEvent event) {
+        // get the source node of the event
+        AccessibilityNodeInfo nodeInfo = event.getSource();
+
+        // Use the event and node information to determine
+        // what action to take
+
+        // take action on behalf of the user
+        nodeInfo.performAction(AccessibilityNodeInfo.ACTION_SCROLL_FORWARD);
+
+        // recycle the nodeInfo object
+        nodeInfo.recycle();
+    }
+    ...
+}
+</pre>
+
+<p>The {@link android.view.accessibility.AccessibilityNodeInfo#performAction performAction()} method
+  allows your service to take action within an application. If your service needs to perform a
+  global action such as navigating to the Home screen, pressing the Back button, opening the
+  notifications screen or recent applications list, then use the
+  {@link android.accessibilityservice.AccessibilityService#performGlobalAction performGlobalAction()}
+  method.</p>
+
+
+<h3 id="focus-types">Using focus types</h3>
+
+<p>Android 4.1 (API Level 16) introduces a new type of user interface focus called <em>Accessibility
+  Focus</em>. This type of focus can be used by accessibility services to select any visible user
+  interface element and act on it. This focus type is different from the more well known <em>Input
+  Focus</em>, which determines what on-screen user interface element receives input when a user
+  types characters, presses <strong>Enter</strong> on a keyboard or pushes the center button of a
+  D-pad control.</p>
+
+<p>Accessibility Focus is completely separate and independent from Input Focus. In fact, it is
+  possible for one element in a user interface to have Input Focus while another element has
+  Accessibility Focus. The purpose of Accessibility Focus is to provide accessibility services with
+  a method of interacting with any visible element on a screen, regardless of whether or not the
+  element is input-focusable from a system perspective. You can see accessibility focus in action by
+  testing accessibility gestures. For more information about testing this feature, see
+  <a href="{@docRoot}tools/testing/testing_accessibility.html#test-gestures">Testing gesture
+  navigation</a>.</p>
+
+<p class="note">
+  <strong>Note:</strong> Accessibility services that use Accessibility Focus are responsible for
+  synchronizing the current Input Focus when an element is capable of this type of focus. Services
+  that do not synchronize Input Focus with Accessibility Focus run the risk of causing problems in
+  applications that expect input focus to be in a specific location when certain actions are taken.
+  </p>
+
+<p>An accessibility service can determine what user interface element has Input Focus or
+  Accessibility Focus using the {@link android.view.accessibility.AccessibilityNodeInfo#findFocus
+  AccessibilityNodeInfo.findFocus()} method. You can also search for elements that can be selected
+  with Input Focus using the
+  {@link android.view.accessibility.AccessibilityNodeInfo#focusSearch focusSearch()} method.
+  Finally, your accessibility service can set Accessibility Focus using the
+  {@link android.view.accessibility.AccessibilityNodeInfo#performAction
+  performAction(AccessibilityNodeInfo.ACTION_SET_ACCESSIBILITY_FOCUS)} method.</p>
+
+
 <h2 id="examples">Example Code</h2>
 
 <p>The API Demo project contains two samples which can be used as a starting point for generating
diff --git a/docs/html/tools/testing/testing_accessibility.jd b/docs/html/tools/testing/testing_accessibility.jd
new file mode 100644
index 0000000000000..daf9b36363733
--- /dev/null
+++ b/docs/html/tools/testing/testing_accessibility.jd
@@ -0,0 +1,257 @@
+page.title=Accessibility Testing Checklist
+parent.title=Testing
+parent.link=index.html
+@jd:body
+
+<div id="qv-wrapper">
+  <div id="qv">
+  <h2>In this document</h2>
+  <ol>
+    <li><a href="#goals">Testing Goals</a></li>
+    <li><a href="#requirements">Testing Requirements</a></li>
+    <li><a href="#recommendations">Testing Recommendations</a></li>
+    <li><a href="#special-cases">Special Cases and Considerations</a></li>
+    <li><a href="#how-to">Testing Accessibility Features</a>
+      <ol>
+        <li><a href="#test-audibles">Testing audible feedback</a></li>
+        <li><a href="#test-navigation">Testing focus navigation</a></li>
+        <li><a href="#test-gestures">Testing gesture navigation</a></li>
+      </ol>
+    </li>
+  </ol>
+
+  <h2>See Also</h2>
+    <ol>
+      <li>
+        <a href="{@docRoot}guide/topics/ui/accessibility/checklist.html">
+        Accessibility Developer Checklist</a>
+      </li>
+      <li>
+        <a href="{@docRoot}design/patterns/accessibility.html">
+        Android Design: Accessibility</a>
+      </li>
+      <li>
+        <a href="{@docRoot}guide/topics/ui/accessibility/apps.html">
+        Making Applications Accessible</a>
+      </li>
+    </ol>
+  </div>
+</div>
+<p>
+  Testing is an important part of making your application accessible to users with varying
+  abilities. Following <a href="{@docRoot}design/patterns/accessibility.html">design</a> and
+  <a href="{@docRoot}guide/topics/ui/accessibility/checklist.html">development</a> guidelines for
+  accessibility are important steps toward that goal, but testing for accessibility can uncover
+  problems with user interaction that are not obvious during design and development.</p>
+
+<p>This accessibility testing checklist guides you through the important aspects of
+  accessibility testing, including overall goals, required testing steps, recommended testing and
+  special considerations. This document also discusses how to enable accessibility features on
+  Android devices for testing purposes.</p>
+
+
+<h2 id="goals">Testing Goals</h2>
+
+<p>Your accessibility testing should have the following, high level goals:</p>
+
+<ul>
+  <li>Set up and use the application without sighted assistance</li>
+  <li>All task workflows in the application can be easily navigated using directional controls and
+    provide clear and appropriate feedback</li>
+</ul>
+
+
+<h2 id="requirements">Testing Requirements</h2>
+
+<p>The following tests must be completed in order to ensure a minimum level of application
+  accessibility.</p>
+
+<ol>
+  <li><strong>Directional controls:</strong> Verify that the application can be operated
+    without the use of a touch screen. Attempt to use only directional controls to accomplish the
+    primary tasks in the application. Use the keyboard and directional-pad (D-Pad) controls in the
+    Android <a href="{@docRoot}tools/devices/emulator.html">Emulator</a> or use
+    <a href="http://support.google.com/nexus/bin/answer.py?hl=en&answer=2700718">gesture
+    navigation</a> on devices with Android 4.1 (API Level 16) or higher.
+    <p class="note"><strong>Note:</strong> Keyboards and D-pads provide different navigation paths
+    than accessibility gestures. While gestures allow users to focus on nearly any on-screen
+    content, keyboard and D-pad navigation only allow focus on input fields and buttons.</p>
+    </li>
+  <li><strong>TalkBack audio prompts:</strong> Verify that user interface controls that provide
+    information (graphics or text) or allow user action have clear and accurate audio descriptions
+    when <a href="#testing-talkback">TalkBack is enabled</a> and controls are focused. Use
+    directional controls to move focus between application layout elements.</li>
+  <li><strong>Explore by Touch prompts:</strong> Verify that user interface controls that
+    provide information (graphics or text) or allow user action have appropriate audio descriptions
+    when <a href="#testing-ebt">Explore by Touch is enabled</a>. There should be no
+    regions where contents or controls do not provide an audio description.</li>
+  <li><strong>Touchable control sizes:</strong> All controls where a user can select or take an
+    action must be a minimum of 48 dp (approximately 9mm) in length and width, as recommended by
+    <a href="{@docRoot}design/patterns/accessibility.html">Android Design</a>.</li>
+  <li><strong>Gestures work with TalkBack enabled:</strong> Verify that app-specific gestures,
+    such as zooming images, scrolling lists, swiping between pages or navigating carousel controls
+    continue to work when <a href="#testing-talkback">TalkBack is enabled</a>. If these gestures do
+    not function, then an alternative interface for these actions must be provided.</li>
+  <li><strong>No audio-only feedback:</strong> Audio feedback must always have a secondary
+    feedback mechanism to support users who are deaf or hard of hearing, for example: A sound alert
+    for the arrival of a message should also be accompanied by a system
+    {@link android.app.Notification}, haptic feedback (if available) or another visual alert.</li>
+</ol>
+
+
+<h2 id="recommendations">Testing Recommendations</h2>
+
+<p>The following tests are recommended for ensuring the accessibility of your application. If you
+  do not test these items, it may impact the overall accessibility and quality of your
+  application.</p>
+
+<ol>
+  <li><strong>Repetitive audio prompting:</strong> Check that closely related controls (such as
+    items with multiple components in a list) do not simply repeat the same audio prompt. For
+    example, in a contacts list that contains a contact picture, written name and title, the prompts
+    should not simply repeat “Bob Smith” for each item.</li>
+  <li><strong>Audio prompt overloading or underloading:</strong> Check that closely related
+    controls provide an appropriate level of audio information that enables users to understand and
+    act on a screen element. Too little or too much prompting can make it difficult to understand
+    and use a control.</li>
+</ol>
+
+
+<h2 id="special-cases">Special Cases and Considerations</h2>
+
+<p>The following list describes specific situations that should be tested to ensure an
+  accessible app. Some, none or all of the cases described here may apply to your application. Be
+  sure to review this list to find out if these special cases apply and take appropriate action.</p>
+
+<ol>
+  <li><strong>Review developer special cases and considerations:</strong> Review the list of
+    <a href="{@docRoot}guide/topics/ui/accessibility/checklist.html#special-cases">special cases</a>
+     for accessibility development and test your application for the cases that apply.</li>
+  <li><strong>Prompts for controls that change function:</strong> Buttons or other controls
+    that change function due to application context or workflow must provide audio prompts
+    appropriate to their current function. For example, a button that changes function from play
+    video to pause video should provide an audio prompt which is appropriate to its current state.</li>
+  <li><strong>Video playback and captioning:</strong> If the application provides video
+    playback, verify that it supports captioning and subtitles to assist users who are deaf or hard
+    of hearing. The video playback controls must clearly indicate if captioning is available for a
+    video and provide a clear way of enabling captions.</li>
+</ol>
+
+
+<h2 id="how-to">Testing Accessibility Features</h2>
+
+<p>Testing of accessibility features such as TalkBack, Explore by Touch and accessibility Gestures
+requires setup of your testing device. This section describes how to enable these features for
+accessibility testing.</p>
+
+
+<h3 id="test-audibles">Testing audible feedback</h3>
+
+<p>Audible accessibility feedback features on Android devices provide audio prompts that speaks
+  the screen content as you move around an application. By enabling these features on an Android
+  device, you can test the experience of users with blindness or low-vision using your application.
+</p>
+
+<p>Audible feedback for users on Android is typically provided by TalkBack accessibility service and
+the Explore by Touch system feature. The TalkBack accessibility service comes preinstalled on most
+Android devices and can also be downloaded for free from
+<a href="https://play.google.com/store/apps/details?id=com.google.android.marvin.talkback">Google
+Play</a>. The Explore by Touch system feature is available on devices running Android 4.0 and later.
+</p>
+
+<h4 id="testing-talkback">Testing with TalkBack</h4>
+
+<p>The <em>TalkBack</em> accessibility service works by speaking the contents of user interface
+controls as the user moves focus onto controls. This service should be enabled as part of testing
+focus navigation and audible prompts.</p>
+
+<p>To enable the TalkBack accessibility service:</p>
+<ol>
+  <li>Launch the <strong>Settings</strong> application.</li>
+  <li>Navigate to the <strong>Accessibility</strong> category and select it.</li>
+  <li>Select <strong>Accessibility</strong> to enable it.</li>
+  <li>Select <strong>TalkBack</strong> to enable it.</li>
+</ol>
+
+<p class="note">
+  <strong>Note:</strong> While TalkBack is the most available Android accessibility service for
+  users with disabilities, other accessibility services are available and may be installed by users.
+</p>
+
+<p>For more information about using TalkBack, see
+<a href="http://support.google.com/nexus/bin/answer.py?hl=en&answer=2700928">Use TalkBack</a>.</p>
+
+<h4 id="testing-ebt">Testing with Explore by Touch</h4>
+
+<p>The <em>Explore by Touch</em> system feature is available on devices running Android 4.0 and
+  later, and works by enabling a special accessibility mode that allows users to drag a finger
+  around the interface of an application and hear the contents of the screen spoken. This feature
+  does not require screen elements to be focused using an directional controller, but listens for
+  hover events over user interface controls.
+</p>
+
+<p>To enable Explore by Touch on Android 4.0 and later:</p>
+<ol>
+  <li>Launch the <strong>Settings</strong> application.</li>
+  <li>Navigate to the <strong>Accessibility</strong> category and select it.</li>
+  <li>Select the <strong>TalkBack</strong> to enable it.
+      <p class="note"><strong>Note:</strong> On Android 4.1 (API Level 16) and higher, the system
+      provides a popup message to enable Explore by Touch. On older versions, you must follow the
+      step below.</p>
+  </li>
+  <li>Return to the <strong>Accessibility</strong> category and select <strong>Explore by
+Touch</strong> to enable it.
+    <p class="note"><strong>Note:</strong> You must turn on TalkBack <em>first</em>, otherwise this
+option is not available.</p>
+  </li>
+</ol>
+
+<p>For more information about using the Explore by Touch features, see
+<a href="http://support.google.com/nexus/bin/answer.py?hl=en&answer=2700722">Use Explore by
+Touch</a>.</p>
+
+<h3 id="test-navigation">Testing focus navigation</h3>
+
+<p>Focus navigation is the use of directional controls to navigate between the individual user
+  interface elements of an application in order to operate it. Users with limited vision or limited
+  manual dexterity often use this mode of navigation instead of touch navigation. As part of
+  accessibility testing, you should verify that your application can be operated using only
+  directional controls.</p>
+
+<p>You can test navigation of your application using only focus controls, even if your test devices
+  does not have a directional controller. The <a href="{@docRoot}tools/help/emulator.html">Android
+  Emulator</a> provides a simulated directional controller that you can use to test navigation. You
+  can also use a software-based directional controller, such as the one provided by the
+  <a href="https://play.google.com/store/apps/details?id=com.googlecode.eyesfree.inputmethod.latin"
+  >Eyes-Free Keyboard</a> to simulate use of a D-pad on a test device that does not have a physical
+  D-pad.</p>
+
+
+<h3 id="test-gestures">Testing gesture navigation</h3>
+
+<p>Gesture navigation is an accessibility navigation mode that allows users to navigate Android
+  devices and applications using specific
+  <a href="http://support.google.com/nexus/bin/answer.py?hl=en&answer=2700718">gestures</a>. This
+  navigation mode is available on Android 4.1 (API Level 16) and higher.</p>
+
+<p class="note"><strong>Note:</strong> Accessibility gestures provide a different navigation path
+than keyboards and D-pads. While gestures allow users to focus on nearly any on-screen
+content, keyboard and D-pad navigation only allow focus on input fields and buttons.</p>
+
+<p>To enable gesture navigation on Android 4.1 and later:</p>
+<ul>
+  <li>Enable both TalkBack and the Explore by Touch feature as described in the
+    <a href="#testing-ebt">Testing with Explore by Touch</a>. When <em>both</em> of these
+    features are enabled, accessibility gestures are automatically enabled.</li>
+  <li>You can change gesture settings using <strong>Settings &gt; Accessibility &gt; TalkBack &gt;
+    Settings &gt; Manage shortcut gestures</strong>.
+</ul>
+
+<p>For more information about using Explore by Touch accessibility gestures, see
+<a href="http://support.google.com/android/bin/topic.py?hl=en&topic=2492346">Accessibility
+gestures</a>.</p>
+
+<p class="note">
+  <strong>Note:</strong> Accessibility services other than TalkBack may map accessibility gestures
+  to different user actions. If gestures are not producing the expected actions during testing, try
+  disabling other accessibility services before proceeding.</p>
\ No newline at end of file
diff --git a/docs/html/tools/tools_toc.cs b/docs/html/tools/tools_toc.cs
index 850e0ecb55fb4..f3936b8c4066f 100644
--- a/docs/html/tools/tools_toc.cs
+++ b/docs/html/tools/tools_toc.cs
@@ -5,7 +5,7 @@
         <a href="<?cs var:toroot ?>tools/index.html"><span class="en">Developer Tools</span></a>
     </div>
   </li>
-  
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot
 ?>sdk/index.html"><span class="en">Download</span></a></div>
@@ -29,7 +29,7 @@
       </li>
     </ul>
   </li>
-  
+
   <li class="nav-section">
     <div class="nav-section-header">
         <a href="/tools/workflow/index.html"><span class="en">Workflow</span></a>
@@ -39,8 +39,8 @@
         <div class="nav-section-header"><a href="/tools/devices/index.html"><span class="en">Setting Up Virtual Devices</span></a></div>
         <ul>
           <li><a href="/tools/devices/managing-avds.html"><span class="en">With AVD Manager</span></a></li>
-          <li><a href="/tools/devices/managing-avds-cmdline.html"><span class="en">From the Command Line</span></a></li>      
-          <li><a href="/tools/devices/emulator.html"><span class="en">Using the Android Emulator</span></a></li>                  
+          <li><a href="/tools/devices/managing-avds-cmdline.html"><span class="en">From the Command Line</span></a></li>
+          <li><a href="/tools/devices/emulator.html"><span class="en">Using the Android Emulator</span></a></li>
         </ul>
       </li>
       <li><a href="/tools/device.html"><span class="en">Using Hardware Devices</span></a></li>
@@ -48,16 +48,16 @@
         <div class="nav-section-header"><a href="/tools/projects/index.html"><span class="en">Setting Up Projects</span></a></div>
         <ul>
           <li><a href="/tools/projects/projects-eclipse.html"><span class="en">From Eclipse with ADT</span></a></li>
-          <li><a href="/tools/projects/projects-cmdline.html"><span class="en">From the Command Line</span></a></li>                      
+          <li><a href="/tools/projects/projects-cmdline.html"><span class="en">From the Command Line</span></a></li>
         </ul>
       </li>
 
-  
+
       <li class="nav-section">
         <div class="nav-section-header"><a href="/tools/building/index.html"><span class="en">Building and Running</span></a></div>
         <ul>
           <li><a href="/tools/building/building-eclipse.html"><span class="en">From Eclipse with ADT</span></a></li>
-          <li><a href="/tools/building/building-cmdline.html"><span class="en">From the Command Line</span></a></li>                    
+          <li><a href="/tools/building/building-cmdline.html"><span class="en">From the Command Line</span></a></li>
         </ul>
       </li>
 
@@ -76,7 +76,7 @@
           </li>
           <li><a href="<?cs var:toroot ?>tools/testing/testing_otheride.html">
             <span class="en">From Other IDEs</span></a>
-          </li>  
+          </li>
           <li>
             <a href="<?cs var:toroot?>tools/testing/activity_testing.html">
             <span class="en">Activity Testing</span></a>
@@ -89,6 +89,10 @@
             <a href="<?cs var:toroot?>tools/testing/contentprovider_testing.html">
             <span class="en">Content Provider Testing</span></a>
           </li>
+          <li>
+            <a href="<?cs var:toroot?>tools/testing/testing_accessibility.html">
+            <span class="en">Accessibility Testing</span></a>
+          </li>
           <li>
             <a href="<?cs var:toroot ?>tools/testing/what_to_test.html">
             <span class="en">What To Test</span></a>
@@ -160,7 +164,7 @@ class="en">MonkeyRunner</span></a></li>
        <li><a href="<?cs var:toroot ?>tools/help/zipalign.html">zipalign</a></li>
     </ul>
   </li>
-  
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot
 ?>tools/revisions/index.html"><span class="en">Revisions</span></a></div>
@@ -178,8 +182,8 @@ class="en">MonkeyRunner</span></a></li>
 class="en">Platforms</span></a></li>
     </ul>
   </li>
-  
-  
+
+
   <li class="nav-section">
     <div class="nav-section-header"><a href="<?cs var:toroot
 ?>tools/extras/index.html"><span class="en">Extras</span></a></div>
@@ -192,13 +196,13 @@ class="en">USB Drivers</span></a>
     </ul>
   </li>
 
-  
+
   <li class="nav-section">
     <div class="nav-section-header empty"><a href="<?cs var:toroot
 ?>tools/samples/index.html"><span class="en">Samples</span></a></div>
   </li>
 
-  
+
   <li class="nav-section">
     <div class="nav-section-header">
     <a href="<?cs var:toroot ?>tools/adk/index.html">
@@ -217,7 +221,7 @@ class="en">USB Drivers</span></a>
       </li>
     </ul>
   </li>
-  
+
 </ul><!-- nav -->
 
 <script type="text/javascript">