[gnome-devel-docs/dx-hackfest: 12/18] platform-overview: Update the ATK section

[Federico Mena Quintero <federico src gnome org>]

commit e6dc9869cd2848e48fb96c3e7d4724ffb15f0a9b
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Jan 31 16:25:43 2013 +0100

    platform-overview: Update the ATK section
    
    Signed-off-by: Federico Mena Quintero <federico gnome org>

 platform-overview/C/atk.page |   42 ++++++++++++++++++++++++++----------------
 1 files changed, 26 insertions(+), 16 deletions(-)
---
diff --git a/platform-overview/C/atk.page b/platform-overview/C/atk.page
index fbca657..b4af48a 100644
--- a/platform-overview/C/atk.page
+++ b/platform-overview/C/atk.page
@@ -13,17 +13,27 @@
 used by people with various disabilities.  Disabilities come in many forms:
 visual impairments, movement impairments, hearing impairments, cognitive
 and language impairments, and seizure disorders.  Many people have some
-sort of disability, and making your application accessibility will allow
-more people to use your application effectively.</p>
+sort of disability, and making your application accessible will allow
+more people to use it effectively, even if they are not disabled.</p>
 
-<p>GNOME provides support for accessibility devices using the ATK
-framework.  This framework defines a set of interfaces to which graphical
-interface components adhere.  This allows, for instance, screen readers
-to read the text of an interface and interact with its controls.  ATK
-support is built into GTK+ and the rest of the GNOME platform, so any
-application using GTK+ will have reasonable accessibility support for
+<p>GNOME provides support for accessibility devices using the ATK framework,
+which stands for Accessibility Tool Kit.  This framework defines a set of
+interfaces to which graphical interface components adhere.  This allows, for
+instance, screen readers to read the text of an interface and interact with its
+controls.  ATK support is built into GTK+ and the rest of the GNOME platform,
+so any application using GTK+ will have reasonable accessibility support for
 free.</p>
 
+<p>ATK solves the problem of plugging many different kinds of widgets (text
+entries, text areas, buttons, menus) with many different types of accessibility
+technologies (screen readers, braille displays, sip-and-puff control devices).
+Instead of writing NxM interfaces, from each widget to each accessibility
+device, one just has to expose a widget through ATK's interfaces.
+Accessibility devices will in turn use these interfaces to query accessible
+widgets.  For example, an aural screen reader and a braille display will both
+use a standard "get the text contents" interface in ATK for all widgets with
+textual information.</p>
+
 <p>Nonetheless, you should be aware of accessibility issues when
 when developing your applications.  Although GTK+ interfaces provide
 reasonable accessibility by default, you can often improve how well
@@ -31,15 +41,15 @@ your program behaves with accessibility tools by providing additional
 information to ATK.  If you develop custom widgets, you should ensure
 that they expose their properties to ATK.  You should also avoid using
 sound, graphics, or color as the sole means of conveying information
-to the user.</p>
+to the user; have redundant ways of providing this information instead of
+relying on the user being to perceive a particular medium.</p>
 
-<p>The GNOME desktop ships with a number of accessibility tools
-which enable users with disabilities to take full advantage of their
-desktop and applications.  Applications that fully implement ATK will
-be able to work with the accessibility tools.  GNOME's accessibility
-tools include a screen reader, a screen magnifier, an on-screen
-keyboard, and <app>Dasher</app>, an innovative
-predictive text entry tool.</p>
+<p>The GNOME desktop ships with a number of accessibility tools which enable
+users with disabilities to take full advantage of their desktop and
+applications.  Applications that fully implement ATK will be able to work with
+the accessibility tools.  These include a screen reader, a screen magnifier, an
+on-screen keyboard, and <app>Dasher</app>, an innovative predictive text entry
+tool.</p>
 
 <list style="compact">
   <item><p><link href="http://developer.gnome.org/accessibility-devel-guide/";>GNOME Accessibility for Developers</link></p></item>