Skip to content

Commit bcd00a7

Browse files
committed
Address further technical feedback
1 parent 0946436 commit bcd00a7

File tree

2 files changed

+11
-13
lines changed

2 files changed

+11
-13
lines changed

source/builders.txt

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -22,20 +22,18 @@ Use Builders Code Pattern
2222
Overview
2323
--------
2424

25-
This page describes how to implement the builders pattern in your code and describes
26-
benefits of using builder classes.
25+
This page describes how to the various available builders in your code and describes
26+
benefits of using the provided builders.
2727

2828
The {+driver-short+} provides type-safe builder classes and methods that enable developers to
29-
efficiently build queries and aggregations. To learn more about the builders pattern,
30-
see `Type-safe builders <https://kotlinlang.org/docs/type-safe-builders.html>`__ in the
31-
{+language+} documentation.
29+
efficiently build queries and aggregations.
3230

33-
Why Use the Builders Code Pattern?
34-
----------------------------------
31+
Why Use Builders?
32+
-----------------
3533

3634
If you use only plain {+language+} to construct BSON query documents, you are not
37-
able to identify errors in your code until runtime. When you use builder classes, you can
38-
write operators as methods and any syntax errors will be caught at compile time.
35+
able to identify syntax errors until runtime. The builders help ensure the corretness of
36+
syntax and can be less verbose than constructing BSON documents.
3937

4038
Example
4139
-------
@@ -89,10 +87,10 @@ query filter:
8987
:copyable:
9088
:dedent:
9189

92-
Builders Pattern
93-
~~~~~~~~~~~~~~~~
90+
Builders
91+
~~~~~~~~
9492

95-
The following example performs the query by using the builders pattern:
93+
The following example performs the query by using the builder helpers:
9694

9795
.. literalinclude:: /includes/builders/builders.kt
9896
:start-after: start-find-builders

source/index.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,7 +88,7 @@ Learn how to work with specialized data formats and custom types in the
8888
Use Builders API
8989
----------------
9090

91-
Learn how to work with the builders pattern in the :ref:`kotlin-sync-builders` section.
91+
Learn how to work with the builder operation helpers in the :ref:`kotlin-sync-builders` section.
9292

9393
FAQ
9494
---

0 commit comments

Comments
 (0)