use readPref method to allow reads from secondaries

Author: kay-kim

source/core/read-preference.txt

@@ -1,5 +1,4 @@
 .. index:: read preference
-.. index:: slaveOk
 .. index:: read preference; background
 .. _replica-set-read-preference:
 .. _replica-set-read-preference-background:

source/includes/ref-toc-method-connection.yaml

@@ -14,10 +14,6 @@ name: ":method:`Mongo.setReadPref()`"
 file: /reference/method/Mongo.setReadPref
 description: "Sets the :term:`read preference` for the MongoDB connection."
 ---
-name: ":method:`Mongo.setSlaveOk()`"
-file: /reference/method/Mongo.setSlaveOk
-description: "Allows operations on the current connection to read from :term:`secondary` members."
----
 name: ":method:`Mongo()`"
 file: /reference/method/Mongo
 description: "Creates a new connection object."

source/includes/ref-toc-method-rs.yaml

@@ -30,10 +30,6 @@ name: ":method:`rs.remove()`"
 file: /reference/method/rs.remove
 description: "Remove a member from a replica set."
 ---
-name: ":method:`rs.slaveOk()`"
-file: /reference/method/rs.slaveOk
-description: "Sets the ``slaveOk`` property for the current connection. Deprecated. Use :method:`~cursor.readPref()` and :method:`Mongo.setReadPref()` to set :term:`read preference`."
----
 name: ":method:`rs.status()`"
 file: /reference/method/rs.status
 description: "Returns a document with information about the state of the replica set."

source/reference/method/Mongo.setReadPref.txt

@@ -30,11 +30,16 @@ Definition
 
         - Description
 
-      * - ``mode``
+      * - :ref:`mode <mongo-setReadPref-mode>`
 
         - string
 
-        - One of the following :term:`read preference` modes: :readmode:`primary`, :readmode:`primaryPreferred`, :readmode:`secondary`, :readmode:`secondaryPreferred`, or :readmode:`nearest`.
+        - .. _mongo-setReadPref-mode:
+
+          One of the following :term:`read preference` modes:
+          :readmode:`primary`, :readmode:`primaryPreferred`,
+          :readmode:`secondary`, :readmode:`secondaryPreferred`, or
+          :readmode:`nearest`.
 
 
 
@@ -51,13 +56,14 @@ Definition
 Examples
 --------
 
+.. _allow-reads-from-secondaries:
 
 Specify Read Preference Mode
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following operation in the :binary:`~bin.mongo` shell sets the read
-preference :ref:`mode <mongo-setReadPref-mode>` to allow reads from
-secondary members and target the read to a secondary member.
+The following operation sets the read preference :ref:`mode
+<mongo-setReadPref-mode>` to target the read to a secondary member.
+This implicitly allows reads from secondaries.
 
 .. code-block:: javascript