DR + RM PR comments

Author: rustagir

source/data-formats/bson.txt

@@ -294,6 +294,8 @@ In addition to the core {+language+} objects, BSON also provides some special ty
 specific to the specification. The following sections describe other
 types that are supported in the driver.
 
+.. _ruby-bson-binary:
+
 BSON::Binary
 ~~~~~~~~~~~~
 
@@ -314,8 +316,19 @@ the bytes encode a particular type of data:
    BSON::Binary.new("binary_string", :user)
    # => <BSON::Binary:0x47113101225420 type=user data=0x62696e6172795f73...>
 
-The valid subtype specifications are ``:generic``, ``:function``,
-``:old``, ``:uuid_old``, ``:uuid``, ``:md5``, and ``:user``.
+The following list provides the valid subtype specifications:
+
+- ``:generic``
+- ``:function``
+- ``:old``
+- ``:uuid_old``
+- ``:uuid``
+- ``:md5``
+- ``:ciphertext``
+- ``:column``
+- ``:sensitive``
+- ``:vector``
+- ``:user``
 
 You can use the ``data`` and ``type`` attributes to retrieve a
 ``Binary`` object's data and the subtype, as shown in the following code:
@@ -455,20 +468,20 @@ BSON::Vector
 Starting in ``bson`` v5.1, you can use the
 ``BSON::Vector`` type to represent vectors of numeric values.
 
-You can create a ``Vector`` object to store values of the following
+You can create a ``BSON::Vector`` object to store values of the following
 types:
 
 - ``int8``
 - ``float32``
 - ``packed_bit``
 
-You can use the optional ``dtype`` and ``padding`` atrributes to specify
+You can use the optional ``dtype`` and ``padding`` attributes to specify
 the data type of the vector and the bit padding, respectively.
-``Vector`` itself is a container to hold your array values, type
-information, and padding specification. ``Vector`` objects are
+``BSON::Vector`` itself is a container to hold your array values, type
+information, and padding specification. ``BSON::Vector`` objects are
 serialized as normal arrays in MongoDB.
 
-The following example demonstrates how to create a ``Vector`` object:
+The following example demonstrates how to create a ``BSON::Vector`` object:
 
 .. code-block:: ruby
 
@@ -477,23 +490,25 @@ The following example demonstrates how to create a ``Vector`` object:
 Convert Vectors to Binary
 `````````````````````````
 
-You can convert ``Vector`` and array objects to ``BSON::Binary`` objects
-so they are serialized as BSON binary vector (subtype 9) instances. Use
-the ``Binary.from_vector`` method, as shown in the following code:
+You can convert ``BSON::Vector`` and array objects to
+:ref:`ruby-bson-binary` objects so they are serialized as BSON binary
+vector (subtype 9) instances. Use the ``BSON::Binary.from_vector``
+method, as shown in the following code:
 
 .. code-block:: ruby
+   
+   vector = BSON::Vector.new([ -0.0016261312, -0.028070757, -0.011342932 ], :float32)
+   BSON::Binary.from_vector(vector)
 
-   BSON::Binary.from_vector([ -0.0016261312, -0.028070757, -0.011342932 ], :float32)
-
-Using the ``Binary`` type improves storage efficiency. To learn
+Using the ``BSON::Binary`` type improves storage efficiency. To learn
 more, see the `BSON specification <https://bsonspec.org/spec.html>`__.
 
-You can convert a ``Binary`` to a ``Vector`` by using the
-``Binary.as_vector`` method.
+You can convert a ``BSON::Binary`` to a ``BSON::Vector`` by using the
+``BSON::Binary.as_vector`` method.
 
 .. tip:: {+avs+}
 
-   To view an example that leverages the ``Binary`` type
+   To view an example that leverages the ``BSON::Binary`` type
    to perform efficient {+avs+} queries, see the :ref:`ruby-avs-examples`.
 
 BSON::Code

source/vector-search.txt

@@ -132,7 +132,7 @@ embedding of the phrase "time travel":
    ``BSON::Binary`` type's vector subtype, introduced in ``bson`` gem v5.1,
    to serve as the query vector. You can also use an array of
    numbers as a query vector, but we recommend that you use the
-   ``Binary`` vector type to improve storage efficiency. To learn more about
+   ``BSON::Binary`` vector type to improve storage efficiency. To learn more about
    this type, see the :ref:`ruby-bson-vector` section of the BSON guide.
 
 Vector Search Score