diff --git a/doc/source/user_guide/getting_started.txt b/doc/source/user_guide/getting_started.txt
index 1d480990..21ea95a3 100644
--- a/doc/source/user_guide/getting_started.txt
+++ b/doc/source/user_guide/getting_started.txt
@@ -2,9 +2,7 @@ Getting started
 ---------------
 
 ``scikit-image`` is an image processing Python package that works with
-:mod:`numpy` arrays. The package is imported as ``skimage``:
-
-::
+:mod:`numpy` arrays. The package is imported as ``skimage``: ::
 
     >>> import skimage
 
@@ -16,7 +14,7 @@ Most functions of ``skimage`` are found within submodules: ::
 A list of submodules and functions is found on the `API reference
 <http://scikit-image.org/docs/0.8.0/api/api.html>`_ webpage.
 
-Within ``scikit-image``, images are represented as NumPy arrays, for
+Within scikit-image, images are represented as NumPy arrays, for
 example 2-D arrays for grayscale 2-D images ::
 
     >>> type(camera)
diff --git a/doc/source/user_guide/numpy_images.txt b/doc/source/user_guide/numpy_images.txt
index dd93db90..c03f703b 100644
--- a/doc/source/user_guide/numpy_images.txt
+++ b/doc/source/user_guide/numpy_images.txt
@@ -30,8 +30,9 @@ modify pixel values: ::
     >>> # Turn to black pixel on 3rd line and 10th column
     >>> camera[3, 10] = 0
 
-Be careful that the first dimension corresponds to lines, while the
-second dimension (fastest varying dimension) stands for columns.
+Be careful that the first dimension (``camera.shape[0]``) corresponds to
+lines, while the second dimension (``camera.shape[1]``) stands for
+columns.
 
 Beyond individual pixels, it is possible to access / modify values of
 whole sets of pixels, using the different indexing possibilities of