fixes

Author: mongoKart

source/data-formats/custom-types.txt

@@ -19,11 +19,7 @@ Custom Types
 Overview
 --------
 
-This guide explains how to create a custom type with {+driver-short+}.
-To create a custom type, define a class that inherits from ``codec_options.TypeCodec``.
-You can use this *type codec* to populate an instance of ``codec_options.TypeRegistry``,
-a type registry. You can then use the type registry to create a custom-type-aware
-``Collection`` object. 
+This guide explains how to use {+driver-short+} to encode and decode custom types.
 
 Encode a Custom Type
 --------------------
@@ -36,6 +32,7 @@ to save an instance of ``Decimal`` with {+driver-short+} results in an
 ``InvalidDocument`` exception, as shown in the following code example:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -45,8 +42,6 @@ to save an instance of ``Decimal`` with {+driver-short+} results in an
       num = Decimal("45.321")
       db.coll.insert_one({"num": num})
 
-      <input code>
-
    .. output::
       :language: shell
 
@@ -127,7 +122,8 @@ Add Codec to the Type Registry
 After defining a custom type codec, you must add it to {+driver-short+}'s **type registry**,
 the list of types the driver can encode and decode.
 To do so, create an instance of the ``TypeRegistry`` class, passing in an instance
-of your type codec class inside a list:
+of your type codec class inside a list. If you create multiple custom codecs, you can
+pass them all to the ``TypeRegistry`` constructor.
 
 .. code-block:: python
 
@@ -136,9 +132,6 @@ of your type codec class inside a list:
    decimal_codec = DecimalCodec()
    type_registry = TypeRegistry([decimal_codec])
 
-If you create multiple custom codecs, you can pass them all to the ``TypeRegistry``
-constructor.
-
 .. note::
 
    Once instantiated, registries are immutable and the only way to add codecs
@@ -161,6 +154,7 @@ object as a keyword argument. Pass your ``CodecOptions`` object to the
 You can then encode and decode instances of the ``Decimal`` class:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -183,6 +177,7 @@ that {+driver-short+} stores an instance of the ``Decimal`` class as a ``Decimal
 value:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -214,6 +209,7 @@ If you try to save an instance of the ``DecimalInt`` class without first registe
 codec for it, {+driver-short+} raises an error:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -243,6 +239,7 @@ You can then add the sublcass's type codec to the type registry and encode insta
 of the custom type:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -309,6 +306,7 @@ You can then use this reference to a collection to store instances of the ``Deci
 class:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -384,6 +382,7 @@ You can then add the ``PickledBinaryDecoder`` to the codec options for a collect
 and use it to encode and decode your custom types:
 
 .. io-code-block::
+   :copyable: true
 
    .. input::
       :language: python
@@ -403,7 +402,7 @@ and use it to encode and decode your custom types:
       my_doc = collection.find_one()
 
       print(isinstance(my_doc["str"], MyStringType))
-      assert(isinstance(my_doc["num"], MyNumberType))
+      print(isinstance(my_doc["num"], MyNumberType))
 
    .. output::
       :language: shell