Find operation fixes (#76)

Author: norareidy

source/usage-examples/find.txt

@@ -25,13 +25,13 @@ learn more about using cursors, see the :ref:`rust-cursor-guide` guide.
 Example
 -------
 
-This example retrieves documents from the ``restaurants`` collection in the
-``sample_restaurants`` database that match a query filter. The example uses a
-``Restaurant`` struct that has ``name`` and ``cuisine`` fields to model the documents
-in the collection.
+This example retrieves documents that match a query filter from the ``restaurants``
+collection in the ``sample_restaurants`` database. The example uses a ``Restaurant``
+struct that has ``name`` and ``cuisine`` fields to model the documents in the
+collection.
 
-The following code passes a query filter as a parameter to the ``find()`` method. The
-filter matches documents in which the value of the ``cuisine`` field is ``"French"``.
+The following code uses a query filter that matches documents in which the value
+of the ``cuisine`` field is ``"French"``.
 
 Select the **Asynchronous** or **Synchronous** tab to see the
 corresponding code for each runtime:

source/usage-examples/findOne.txt

@@ -9,15 +9,14 @@ You can retrieve a single document in a collection by calling the `find_one()
 
 Pass a query filter to the ``find_one()`` method to return one document in the collection
 that matches the filter. If multiple documents match the query filter, this method returns
-the first matching document according to their :term:`natural order` in the database, or
+the first matching document according to their :term:`natural order` in the database or
 according to the sort order specified in a ``FindOneOptions`` instance.
 
-The ``find_one()`` method returns a `Result<Option<T>> <{+api+}/error/type.Result.html>`__
-type. 
+The ``find_one()`` method returns an `Option<T> <https://doc.rust-lang.org/nightly/core/option/enum.Option.html>`__
+type, where ``<T>`` is the type with which you parameterized your ``Collection``
+instance.
 
-.. tip::
-
-    To learn more about retrieving documents, see the :ref:`rust-retrieve-guide` guide.
+To learn more about retrieving documents, see the :ref:`rust-retrieve-guide` guide.
 
 Example
 -------