Apply suggestions from code review

Co-authored-by: Lambros Petrou <[email protected]>

Author: Oxyjun

src/content/docs/d1/best-practices/retry-queries.mdx

@@ -16,7 +16,7 @@ D1 automatically retries read-only queries up to 2 more times when it encounters
 
 ## Example of retrying queries
 
-Consider the following example, taken from the [D1 read replication starter template](https://github.com/cloudflare/templates/blob/main/d1-starter-sessions-api-template/src/index.ts#L108).
+Consider the following example of a `shouldRetry(...)` function, taken from the [D1 read replication starter template](https://github.com/cloudflare/templates/blob/main/d1-starter-sessions-api-template/src/index.ts#L108).
 
 You should make sure your retries apply an exponential backoff with jitter strategy for more successful retries.
 You can use libraries abstracting that already like [`@cloudflare/actors`](https://github.com/cloudflare/actors), or [copy the retry logic](https://github.com/cloudflare/actors/blob/9ba112503132ddf6b5cef37ff145e7a2dd5ffbfc/packages/core/src/retries.ts#L18) in your own code directly.
@@ -25,7 +25,7 @@ You can use libraries abstracting that already like [`@cloudflare/actors`](https
 import { tryWhile } from "@cloudflare/actors";
 
 function queryD1Example(d1: D1Database, sql: string) {
-  const result = await tryWhile(async () => {
+  return tryWhile(async () => {
     return await d1.prepare(sql).run();
   }, shouldRetry);
 }

src/content/docs/d1/worker-api/return-object.mdx

@@ -37,7 +37,7 @@ The methods [`D1PreparedStatement::run`](/d1/worker-api/prepared-statements/#run
     size_after: number, // the size of the database after the query is successfully applied
     rows_read: number, // the number of rows read (scanned) by this query
     rows_written: number // the number of rows written by this query
-    total_attempts: number //the number of total attempts to execute read-only, retryable query
+    total_attempts: number //the number of total attempts to successfully execute the query, including retries
   }
   results: array | null, // [] if empty, or null if it does not apply
 }