summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlejandro Piñeiro <apinheiro@igalia.com>2014-02-18 18:29:29 +0100
committerAlejandro Piñeiro <apinheiro@igalia.com>2014-02-18 18:29:29 +0100
commitfdf5f9c1cb5af00fd9a85534bc1460fa3d2869e1 (patch)
tree5f517e8404462459d0c1a7d4f2119e6d6e0ecfa7
parent12861d77fb76628e41c1f7837e1b291c5fb1165c (diff)
downloadatk-fdf5f9c1cb5af00fd9a85534bc1460fa3d2869e1.tar.gz
doc: add an overview
This is the same overview used for ATK releases. In any case this should be improved and updated.
-rw-r--r--docs/atk-docs.sgml20
1 files changed, 19 insertions, 1 deletions
diff --git a/docs/atk-docs.sgml b/docs/atk-docs.sgml
index dfe315a..9f9c736 100644
--- a/docs/atk-docs.sgml
+++ b/docs/atk-docs.sgml
@@ -42,7 +42,25 @@
<chapter id="overview">
<title>Overview</title>
- Atk is cool
+ <para>
+ 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 free.
+ </para>
+
+ <para>
+ 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
+ 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
+ </para>
+
</chapter>
<chapter id="atkobject">