[tepl] docs: minor improvements

[Sébastien Wilmet <swilmet src gnome org>]

commit c391188b2edbffb3b0cb3376d2befdb34a9bafcf
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sat Jul 29 20:20:36 2017 +0200

    docs: minor improvements

 docs/reference/api-breaks.xml |    8 +++++---
 docs/reference/intro.xml.in   |    4 ++--
 2 files changed, 7 insertions(+), 5 deletions(-)
---
diff --git a/docs/reference/api-breaks.xml b/docs/reference/api-breaks.xml
index adb76cf..44b29f3 100644
--- a/docs/reference/api-breaks.xml
+++ b/docs/reference/api-breaks.xml
@@ -70,15 +70,17 @@
       </listitem>
       <listitem>
         <para>
-          Add <link linkend="AmtkFactory">AmtkFactory</link> and
-          <link linkend="AmtkFactoryMenu">AmtkFactoryMenu</link>, which replace
+          The <link linkend="AmtkFactory">AmtkFactory</link> and
+          <link linkend="AmtkFactoryMenu">AmtkFactoryMenu</link> classes have
+          been added, which replace
           <code>gtef_action_info_store_create_menu_item()</code> and removes the
           <code>GtefActionInfoStore:application</code> property.
         </para>
       </listitem>
       <listitem>
         <para>
-          Rename <code>gtef_action_info_central_store_get_instance()</code> to
+          <code>gtef_action_info_central_store_get_instance()</code> has been
+          renamed to
           <link 
linkend="amtk-action-info-central-store-get-singleton">amtk_action_info_central_store_get_singleton()</link>.
         </para>
       </listitem>
diff --git a/docs/reference/intro.xml.in b/docs/reference/intro.xml.in
index c4bdd28..ff179ed 100644
--- a/docs/reference/intro.xml.in
+++ b/docs/reference/intro.xml.in
@@ -104,8 +104,8 @@
     <para>
       Tepl uses the same
       <ulink url="https://developer.gnome.org/programming-guidelines/stable/versioning.html.en";>versioning 
scheme</ulink>
-      as GNOME. API/ABI stability is guaranteed. For example Tepl 3.2 is
-      backward-compatible with Tepl 3.0 (those versions don't necessarily exist,
+      as GNOME. API/ABI stability is guaranteed. For example Tepl 17.2 is
+      backward-compatible with Tepl 17.0 (those versions don't necessarily exist,
       it's just an example). But the peculiarity of Tepl is that new major
       versions are released more often, at most every 6 months if needed.
       Different major versions can be installed in parallel, like GTK+&nbsp;2