cleaning up wording and pep

choldgraf · choldgraf · commit 3d55690c20e8 · 2017-10-21T10:51:16.000-07:00
diff --git a/examples/widgets/buttons.py b/examples/widgets/buttons.py
@@ -2,7 +2,11 @@
 =======
 Buttons
 =======
-The program shows a simple GUI with a sine wave changing its frequency.The next and previous button widget used here helps shows the wave with new frequency.
+
+Constructing a simple button GUI to modify a sine wave.
+
+The ``next`` and ``previous`` button widget helps visualize the wave with
+new frequencies.
 """
 
 import numpy as np
diff --git a/examples/widgets/check_buttons.py b/examples/widgets/check_buttons.py
@@ -2,7 +2,12 @@
 =============
 Check Buttons
 =============
-This program shows the use of 'Check Buttons' which is similar to our usual check boxes. There are 3 different sine waves which are shown and by checking the boxes, we can choose which waves we want to see.
+
+Turning visual elements on and off with check buttons.
+
+This program shows the use of 'Check Buttons' which is similar to
+check boxes. There are 3 different sine waves shown and we can choose which
+waves are displayed with the check buttons.
 """
 import numpy as np
 import matplotlib.pyplot as plt
diff --git a/examples/widgets/lasso_selector_demo_sgskip.py b/examples/widgets/lasso_selector_demo_sgskip.py
@@ -2,8 +2,12 @@
 ===================
 Lasso Selector Demo
 ===================
-An example to show the use of Lasso Selector widget. The graph shows a scatter plot. You can select a few points by drawing a lasso loop around the points on the graphjust like any other Lasso tool. To draw, just click on the graph,hold and drag it around the points you need to select.
 
+Interactively selecting data points with the lasso tool.
+
+This examples plots a scatter plot. You can then select a few points by drawing
+a lasso loop around the points on the graph. To draw, just click
+on the graph, hold, and drag it around the points you need to select.
 """
 from __future__ import print_function
 
diff --git a/examples/widgets/multicursor.py b/examples/widgets/multicursor.py
@@ -2,7 +2,12 @@
 ===========
 Multicursor
 ===========
-A program to show multiple cursors. The graph has two subplots and on hovering the cursor over the two seperate graphs, the values are shown respectively.
+
+Showing a cursor on multiple plots simultaneously.
+
+This example generates two subplots and on hovering
+the cursor over data in one subplot, the values of that datapoint
+are shown in both respectively.
 """
 import numpy as np
 import matplotlib.pyplot as plt
diff --git a/examples/widgets/slider_demo.py b/examples/widgets/slider_demo.py
@@ -2,7 +2,12 @@
 ===========
 Slider Demo
 ===========
-An example to show the use of slider widget. In this example, slider is used to choose the frequency of the wave.
+
+Using the slider widget to control visual properties of your plot.
+
+In this example, a slider is used to choose the frequency of a sine
+wave. You can control many continuously-varying properties of your plot in
+this way.
 """
 import numpy as np
 import matplotlib.pyplot as plt
diff --git a/examples/widgets/textbox.py b/examples/widgets/textbox.py
@@ -2,7 +2,12 @@
 =======
 Textbox
 =======
-It shows the use of textbox widget. You can use it mention any text that needs to be displayed or formulas or values. You can further use it to take input from the user, and use a submit button to create plots using the given input(Just a use case).
+
+Allowing text input with the Textbox widget.
+
+You can use the Textbox widget to let users provide any text that needs to be
+displayed, including formulas. You can use a submit button to create plots
+with the given input.
 """
 
 import numpy as np
