Skip to content

Commit bcfa199

Browse files
committed
Fix
1 parent 40d8ad1 commit bcfa199

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

website/src/pages/critique.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ _aka "I have to learn a new syntax"_
55

66
### Use SOQL Evaluator
77

8-
SOQL Lib has 3 different modules: [SOQL](/soql/getting-started), [SOQL Cache](/cache/getting-started), and [SOQL Evaluator](/evaluator/getting-started). SOQL Evaluator was created for developers who don't want to learn a new syntax but still want to benefit from features like mocking and result functions. You can use [this module](https://github.com/beyond-the-cloud-dev/soql-lib/tree/main/force-app/main/default/classes/main/soql-evaluator) without switching to an entirely new syntax.
8+
SOQL Lib has 3 different modules: [SOQL](../../docs/soql/getting-started.md/), [SOQL Cache](../../docs/cache/getting-started.md), and [SOQL Evaluator](../../docs/evaluator/getting-started.md). SOQL Evaluator was created for developers who don't want to learn a new syntax but still want to benefit from features like mocking and result functions. You can use [this module](https://github.com/beyond-the-cloud-dev/soql-lib/tree/main/force-app/main/default/classes/main/soql-evaluator) without switching to an entirely new syntax.
99

1010
```apex
1111
Set<Id> accountIds = SOQLEvaluator.of([SELECT Id FROM Account]).toIds();
@@ -16,7 +16,7 @@ List<String> accountNames = SOQLEvaluator.of([SELECT Id, Name FROM Account]).toV
1616

1717
#### Documentation
1818

19-
SOQL Lib provides comprehensive online documentation with the [playground](./playground) and numerous [examples](/soql/examples/select). You can also use the search feature in the top-right corner to find what you're looking for. The Fluent API was designed to stay as close to traditional SOQL syntax as possible. However, due to Apex's `Identifier name is reserved` restriction, some keywords like `select`, `where`, and `limit` couldn't be used.
19+
SOQL Lib provides comprehensive online documentation with the [playground](./playground.js) and numerous [examples](../../docs/soql/examples/select.md). You can also use the search feature in the top-right corner to find what you're looking for. The Fluent API was designed to stay as close to traditional SOQL syntax as possible. However, due to Apex's `Identifier name is reserved` restriction, some keywords like `select`, `where`, and `limit` couldn't be used.
2020

2121
#### Interfaces
2222

@@ -32,7 +32,7 @@ A simple prompt in your IDE integrated with AI can be very helpful: "Based on SO
3232

3333
#### Result Functions
3434

35-
SOQL Lib provides numerous [result functions](/soql/examples/result) that make your code easier to read and understand. Most operations you typically perform on SOQL results are available as methods in SOQL Lib. Instead of repeating the same transformations throughout your codebase, simply use result methods.
35+
SOQL Lib provides numerous [result functions](../../docs/soql/examples/result.md) that make your code easier to read and understand. Most operations you typically perform on SOQL results are available as methods in SOQL Lib. Instead of repeating the same transformations throughout your codebase, simply use result methods.
3636

3737
**Apex**
3838

@@ -95,11 +95,11 @@ SOQL Lib builds a query string and passes it to the `Database.queryWithBinds` me
9595

9696
Not much. While dynamic code can be CPU-intensive, we've run extensive performance tests (full results coming soon). Here's a preview:
9797

98-
### Result Functions
99-
10098
Building a complex query dynamically with SOQL Lib consumes less than **2ms**, and around **1ms** for simple queries.
10199
Even if you execute 100 complex queries in one transaction (101 SOQL queries per synchronous transaction), in the worst-case scenario, SOQL Lib uses only ~200ms out of the 10,000ms CPU limit available.
102100

101+
### Result Functions
102+
103103
Additionally, SOQL Lib can be faster than your own implementation. We perform internal optimizations for certain result functions.
104104
For instance:
105105

@@ -119,13 +119,12 @@ Set<String> accountNames = SOQL.of(Account.SObjectType).toValuesOf(Account.Name)
119119

120120
### Mocking
121121

122-
How long does it take to run Apex unit tests with all test data inserted? Typically seconds, or even minutes.
123-
124-
How long does it take to run Apex unit tests when query results are mocked and there's no need to create test data? Milliseconds to seconds—definitely not minutes.
122+
How long it takes to run Apex Unit Tests with all test data inserted? I think seconds, or even minutes.
123+
How long it takes to run Apex Unit Tests when query results are mocked and there is no need to create a test data? miliseconds to seconds, but for sure not minutes.
125124

126-
I don't need to emphasize the benefits of writing fast, reliable unit tests. Instead of spending time figuring out how to set fields so validation rules pass, or determining what setup is needed to avoid trigger errors, mocking allows you to return query results without any database operations.
125+
I wouldn't mentioned the benefits of writing fast, reliable unit tests. Instead of spending time on trying to figure out how to set fields so validation rules will pass, what to set up to pass the trigger without error etc. Mocking allows you to get result from the query without all operations on the database.
127126

128-
With mocking, you not only save hours on test data creation but also reduce test execution time by minutes. If someone argues that SOQL Lib consumes CPU time, they should consider that they cannot afford NOT to mock query results.
127+
Here we can not only save hours of figuring out test data creation, but also minutes during tests execution. So if someone says that SOQL Lib take CPU time and that bothers those people. I believe they cannot allow themselfs to
129128

130129
## It's Just a Query Builder
131130

@@ -143,6 +142,6 @@ The query builder is just one component of SOQL Lib. SOQL Lib itself is a lightw
143142
- Use the query builder to avoid string concatenation
144143

145144
**For a comprehensive list of benefits, check:**
146-
- [SOQL Basic Features](/soql/basic-features)
147-
- [SOQL Cache Basic Features](/cache/basic-features)
145+
- [SOQL Basic Features](../../docs/soql/basic-features.md)
146+
- [SOQL Cache Basic Features](../../docs/cache/basic-features.md)
148147

0 commit comments

Comments
 (0)