diff --git a/reference/mongo/readpreferences.xml b/reference/mongo/readpreferences.xml
index 42cdcd4c97..32676c972d 100644
--- a/reference/mongo/readpreferences.xml
+++ b/reference/mongo/readpreferences.xml
@@ -186,12 +186,8 @@
for tag sets.
- When specifying read preference modes in a query string, the names
- primary, primaryPreferred,
- secondary, secondaryPreferred, and
- nearest should be used instead of the constants for the
- readPreference value. Tag sets for the
- readPreferenceTags value should be a comma-delimited
+ When specifying read preference modes in a query string, the Tag sets for
+ the readPreferenceTags value should be a comma-delimited
sequence of colon-delimited key/value pairs.
@@ -203,6 +199,14 @@
they appear in the query string.
+
+
+ If the driver cannot find a matching TagSet the read will fail! It is
+ your responsibility of providing suitable fallback, such as an empty
+ readPreferenceTags value to fallback to "no TagSet
+ preference".
+
+
Connection URI read preferences with query string syntax