Improve docs

bigmontz · bigmontz · commit 7db0712c0f33 · 2023-01-25T11:46:21.000+01:00
diff --git a/packages/core/src/driver.ts b/packages/core/src/driver.ts
@@ -398,7 +398,9 @@ class Driver {
    *
    * This method is a shortcut for a {@link Session#executeRead} and {@link Session#executeWrite}.
    *
-   * NOTE: `CALL {} IN TRANSACTIONS` and `USING PERIODIC COMMIT` are not supported by this method.
+   * NOTE: Because it is an explicit transaction from the server point of view, Cypher queries using
+   * "CALL {} IN TRANSACTIONS" or the older "USING PERIODIC COMMIT" construct will not work (call
+   * {@link Session#run} for these).
    *
    * @example
    * // Run a simple write query
diff --git a/packages/neo4j-driver-deno/lib/core/driver.ts b/packages/neo4j-driver-deno/lib/core/driver.ts
@@ -398,7 +398,9 @@ class Driver {
    *
    * This method is a shortcut for a {@link Session#executeRead} and {@link Session#executeWrite}.
    *
-   * NOTE: `CALL {} IN TRANSACTIONS` and `USING PERIODIC COMMIT` are not supported by this method.
+   * NOTE: Because it is an explicit transaction from the server point of view, Cypher queries using
+   * "CALL {} IN TRANSACTIONS" or the older "USING PERIODIC COMMIT" construct will not work (call
+   * {@link Session#run} for these).
    *
    * @example
    * // Run a simple write query

Original file line number	Diff line number	Diff line change
`@@ -398,7 +398,9 @@ class Driver {`
`398`	`398`	`*`
`399`	`399`	`* This method is a shortcut for a {@link Session#executeRead} and {@link Session#executeWrite}.`
`400`	`400`	`*`
`401`		- * NOTE: `CALL {} IN TRANSACTIONS` and `USING PERIODIC COMMIT` are not supported by this method.
	`401`	`+ * NOTE: Because it is an explicit transaction from the server point of view, Cypher queries using`
	`402`	`+ * "CALL {} IN TRANSACTIONS" or the older "USING PERIODIC COMMIT" construct will not work (call`
	`403`	`+ * {@link Session#run} for these).`
`402`	`404`	`*`
`403`	`405`	`* @example`
`404`	`406`	`* // Run a simple write query`