Fix :meth: links.

Author: daspecster

docs/vision-usage.rst

@@ -16,14 +16,14 @@ Authentication and Configuration
   this will be detected automatically.
 
 - After configuring your environment, create a
-  :class:`~google.cloud.vision.client.Client`
+  :class:`~google.cloud.vision.client.Client`.
 
 .. code-block:: python
 
      >>> from google.cloud import vision
      >>> client = vision.Client()
 
-or pass in ``credentials`` and ``project`` explicitly
+or pass in ``credentials`` and ``project`` explicitly.
 
 .. code-block:: python
 
@@ -34,8 +34,9 @@ or pass in ``credentials`` and ``project`` explicitly
 Face Detection
 ~~~~~~~~~~~~~~
 
-:meth:`detect_faces` will search for faces in an image and return the
-coordinates in the image of each `landmark type`_ that was detected.
+:meth:`~google.cloud.vision.image.Image.detect_faces` will search for faces in
+an image and return the coordinates in the image of each `landmark type`_ that
+was detected.
 
 .. _landmark type: https://cloud.google.com/vision/reference/rest/v1/images/annotate#type_1
 
@@ -60,10 +61,10 @@ coordinates in the image of each `landmark type`_ that was detected.
 Label Detection
 ~~~~~~~~~~~~~~~
 
-:meth:`detect_labels` will attempt to label objects in an image.
-If there is a car, person and a dog in the image, label detection will
-attempt to identify those objects and score the level of certainty from
-``0.0 to 1.0``.
+:meth:`~google.cloud.vision.image.Image.detect_labels` will attempt to label
+objects in an image. If there is a car, person and a dog in the image, label
+detection will attempt to identify those objects and score the level of
+certainty from ``0.0 to 1.0``.
 
 .. code-block:: python
 
@@ -80,9 +81,9 @@ attempt to identify those objects and score the level of certainty from
 Landmark Detection
 ~~~~~~~~~~~~~~~~~~
 
-:meth:`detect_landmarks` will attempt to detect landmarks such as
-"Mount Rushmore" and the "Sydney Opera House". The API will also provide their
-known geographical locations if available.
+:meth:`~google.cloud.vision.image.Image.detect_landmarks` will attempt to
+detect landmarks such as "Mount Rushmore" and the "Sydney Opera House". The API
+will also provide their known geographical locations if available.
 
 .. code-block:: python
 
@@ -106,9 +107,9 @@ known geographical locations if available.
 Logo Detection
 ~~~~~~~~~~~~~~
 
-With :meth:`detect_logos`, you can identify brand logos in an image. Their
-shape and location in the image can be found by iterating through the detected
-logo's ```vertices``.
+With :meth:`~google.cloud.vision.image.Image.detect_logos`, you can identify
+brand logos in an image. Their shape and location in the image can be found by
+iterating through the detected logo's ``vertices``.
 
 .. code-block:: python
 
@@ -135,12 +136,12 @@ logo's ```vertices``.
 Safe Search Detection
 ~~~~~~~~~~~~~~~~~~~~~
 
-:meth:`detect_safe_search` will try to categorize the entire contents of the
-image under four categories.
+:meth:`~google.cloud.vision.image.Image.detect_safe_search` will try to
+categorize the entire contents of the image under four categories.
 
 - adult: Represents the likelihood that the image contains adult content.
 - spoof: The likelihood that an obvious modification was made to the image's
-         canonical version to make it appear funny or offensive.
+  canonical version to make it appear funny or offensive.
 - medical: Likelihood this is a medical image.
 - violence: Violence likelihood.
 
@@ -150,21 +151,23 @@ image under four categories.
     >>> client = vision.Client()
     >>> with open('./image.jpg', 'rb') as image_file:
     ...     image = client.image(content=image_file.read())
-    >>> safe_search = image.detect_safe_search()
-    >>> safe_search[0].adult
+    >>> safe_search_results = image.detect_safe_search()
+    >>> safe_search = safe_search_results[0]
+    >>> safe_search.adult
     'VERY_UNLIKELY'
-    >>> safe_search[0].spoof
+    >>> safe_search.spoof
     'POSSIBLE'
-    >>> safe_search[0].medical
+    >>> safe_search.medical
     'VERY_LIKELY'
-    >>> safe_search[0].violence
+    >>> safe_search.violence
     'LIKELY'
 
 
 Text Detection
 ~~~~~~~~~~~~~~
 
-:meth:`detect_text` performs OCR to find text in an image.
+:meth:`~google.cloud.vision.image.Image.detect_text` performs OCR to find text
+in an image.
 
 .. code-block:: python
 
@@ -184,8 +187,8 @@ Text Detection
 Image Properties
 ~~~~~~~~~~~~~~~~
 
-:meth:`detect_properties` will process the image and determine the dominant
-colors in the image.
+:meth:`~google.cloud.vision.image.Image.detect_properties` will process the
+image and determine the dominant colors in the image.
 
 .. code-block:: python
 
@@ -195,13 +198,14 @@ colors in the image.
     ...     image = client.image(content=image_file.read())
     >>> results = image.detect_properties()
     >>> colors = results[0]
-    >>> colors[0].red
+    >>> first_color = colors[0]
+    >>> first_color.red
     244
-    >>> colors[0].blue
+    >>> first_color.blue
     134
-    >>> colors[0].score
+    >>> first_color.score
     0.65519291
-    >>> colors[0].pixel_fraction
+    >>> first_color.pixel_fraction
     0.758658
 
 
@@ -212,7 +216,7 @@ If no results for the detection performed can be extracted from the image, then
 an empty list is returned. This behavior is similiar with all detection types.
 
 
-Example with :meth:`detect_logos`:
+Example with :meth:`~google.cloud.vision.image.Image.detect_logos`:
 
 .. code-block:: python