diff --git a/doc/sources/gettingstarted/framework.rst b/doc/sources/gettingstarted/framework.rst
index b07c7c692..d97f02c57 100644
--- a/doc/sources/gettingstarted/framework.rst
+++ b/doc/sources/gettingstarted/framework.rst
@@ -3,21 +3,36 @@ Non-widget stuff
 
 .. |animation_img| image:: ../images/gs-animation.gif
 
-.. |animation_text| replace:: :class:`Animation <kivy.animation.Animation>` is used to change a Widget's properties (size/pos/center...), to a target value, in a target time.
-    Various :class:`transition <kivy.animation.AnimationTransition>` functions are provided. 
-    Using them, you can animate widgets and build very smooth UI behaviours.
+.. |animation_text| replace:: :class:`Animation <kivy.animation.Animation>` is
+    used to change a widget's properties (size/pos/center etc.) to a target
+    value within a target time.
+    Various :class:`transition <kivy.animation.AnimationTransition>` functions
+    are provided. You can use them to animate widgets and build very smooth UI
+    behaviours.
 
 .. |atlas_img| image:: ../images/gs-atlas.png
 
-.. |atlas_text| replace:: :class:`Atlas <kivy.atlas.Atlas>` is a class for managing texture maps, i.e. packing multiple textures into one image. Using it allows you to reduce the number of images to load and speed up the application start.
+.. |atlas_text| replace:: :class:`Atlas <kivy.atlas.Atlas>` is a class for
+    managing texture maps i.e. packing multiple textures into one image.
+    This allows you to reduce the number of images loaded and thus speed up the
+    application start.
 
-.. |clock_text| replace:: :class:`Clock <kivy.clock.Clock>` provides you with a convenient way to do jobs at set time intervals and is preferred over *sleep()*  which would block the kivy Event Loop. These intervals can be set relative to the OpenGL Drawing instructions, :ref:`before <schedule-before-frame>` or :ref:`after <schedule-before-frame>` frame.  Clock also provides you with a way to create :ref:`triggered events <triggered-events>` that are grouped together and only called once before the next frame.
+.. |clock_text| replace:: :class:`Clock <kivy.clock.Clock>` provides you with a
+    convenient way to schecdule jobs at set time intervals and is preferred
+    over *sleep()*,  which would block the kivy event loop. These intervals can
+    be set relative to the OpenGL drawing instructions,
+    :ref:`before <schedule-before-frame>` or
+    :ref:`after <schedule-before-frame>`. The Clock also provides you with a way
+    to create :ref:`triggered events <triggered-events>` that are grouped
+    together and called only once before the next frame.
 
 .. |sched_once| replace:: :meth:`~kivy.clock.ClockBase.schedule_once`
 .. |sched_intrvl| replace:: :meth:`~kivy.clock.ClockBase.schedule_interval`
 .. |unsched| replace:: :meth:`~kivy.clock.ClockBase.unschedule`
 .. |trigger| replace:: :meth:`~kivy.clock.ClockBase.create_trigger`
-.. |urlreq| replace:: :class:`UrlRequest <kivy.network.urlrequest.UrlRequest>` is useful to do asynchronous requests without blocking the event loop, and manage the result and progress with callbacks.
+.. |urlreq| replace:: :class:`UrlRequest <kivy.network.urlrequest.UrlRequest>`
+    is useful for asynchronous requests that do not block the event loop, and
+    manage the result and progress with callbacks.
 
 +------------------+------------------+
 | |animation_text| |   |animation_img||