Skip to content

Commit 68f2a68

Browse files
authored
DOCSP-37264: Add text comparing async vs sync/LINQ vs builder usecases (#195)
1 parent 8553e6d commit 68f2a68

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

source/faq.txt

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -183,6 +183,18 @@ The error message consists of multiple parts:
183183
can use tools like ``openssl s_client`` to debug TLS/SSL-related
184184
certificate problems.
185185

186+
.. _csharp-faq-linq-vs-builder:
187+
188+
Should I Use LINQ or Builder Classes When Querying for Documents?
189+
-----------------------------------------------------------------
190+
191+
If you're used to programming in {+language+}, consider using LINQ because of its similar feel
192+
to programming in native {+language+}. If you have prior experience with other MongoDB drivers,
193+
consider using Builder classes because of their consistency with other drivers.
194+
195+
We encourage experimenting with both approaches to determine the most suitable mechanism
196+
for your purposes.
197+
186198
.. _csharp-faq-unsupported-expressions:
187199

188200
Why are Certain LINQ or Builder Expressions Unsupported?

source/usage-examples.txt

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,18 @@ operations. Each example provides the following information:
4242

4343
- The expected result after running the example
4444

45+
.. tip::
46+
47+
Whether you use a synchronous or asynchronous framework in your application depends
48+
on your use case. Synchronous calls are more suitable for simple query workflows or
49+
when you must implement sequential logic. Consider using asynchronous calls if
50+
your application relies on multiple concurrent database requests or if your
51+
program doesn't require an immediate response from the database to continue
52+
executing.
53+
54+
We encourage experimenting with both approaches to determine the most
55+
suitable framework for your purposes.
56+
4557
How to Use the Usage Examples
4658
-----------------------------
4759

0 commit comments

Comments
 (0)