JT tech review 2

docs/query-builder.txt

@@ -41,7 +41,7 @@ Chain methods to specify commands and any constraints. Then, chain
 the ``get()`` method at the end to run the methods and retrieve the
 results. To retrieve only the first matching result, chain the
 ``first()`` method instead of the ``get()`` method. Starting in
-{+odm-long+} v5.0, the query builder returns results as objects.
+{+odm-long+} v5.0, the query builder returns results as ``stdClass`` objects.
 
 The following example shows the syntax of a query builder call:
 

docs/upgrade.txt

@@ -71,20 +71,25 @@ Version 5.x Breaking Changes
 
 This library version introduces the following breaking changes:
 
-- The query builder returns results as objects, instead of as arrays.
- This change requires that you change array access to property access
- when interacting with query results.
+- The query builder returns results as as ``stdClass`` objects, instead
+ of as arrays. This change requires that you change array access to
+ property access when interacting with query results.
 
  The following code shows how to retrieve a query result and access a
- property from the result object:
+ property from the result object in older versions compared to v5.0:
 
  .. code-block:: php
- :emphasize-lines: 4
+ :emphasize-lines: 8
 
- DB::table('accounts')
+ $document = DB::table('accounts')
  ->where('name', 'Anita Charles')
- ->first()
- ->balance
+ ->first();
+
+ // older versions
+ $document['balance'];
+
+ // v5.0
+ $document->balance;
 
 - In query results, the library converts BSON ``UTCDateTime`` objects to ``Carbon``
  date classes, applying the default timezone.