addressing some comments

Author: MaxAake

README.md

@@ -44,7 +44,7 @@ var neo4j = require('neo4j-driver')
 import neo4j from 'neo4j-driver'
 ```
 
-Driver instance should be closed when Node.js application exits:
+Driver instance should be closed when the application exits:
 
 ```javascript
 driver.close() // returns a Promise
@@ -103,7 +103,7 @@ import neo4j from 'https://cdn.jsdelivr.net/npm/[email protected]/lib/browser/n
 ```
 
 It is not required to explicitly close the driver on a web page. Web browser should gracefully close all open
-WebSockets when the page is unloaded. However, driver instance should be explicitly closed when its lifetime
+WebSockets when the page is unloaded. However, driver instance should be explicitly closed when it's lifetime
 is not the same as the lifetime of the web page:
 
 ```javascript
@@ -116,13 +116,13 @@ driver.close() // returns a Promise
 
 ```javascript
 // Create a driver instance, for the user `neo4j` with password `password`.
-// It should be enough to have a single driver per DBMS per application.
+// It should be enough to have a single driver per database per application.
 var driver = neo4j.driver(
   'neo4j://localhost',
   neo4j.auth.basic('neo4j', 'password')
 )
 
-// Close the driver when the application exits.
+// Close the driver when application exits.
 // This closes all used network connections.
 await driver.close()
 ```
@@ -226,7 +226,7 @@ readTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 #### Reading with Reactive Session
@@ -270,7 +270,7 @@ writeTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 #### Writing with Reactive Session
@@ -295,14 +295,15 @@ rxSession
 ```javascript
 // Since 5.8.0, the driver has offered a way to run a single query transaction with minimal boilerplate.
 // The driver.executeQuery() function features the same automatic retries as transaction functions.
+// 
 var executeQueryResultPromise = driver
   .executeQuery(
-    "MATCH (alice:Person {name: $nameParam}) RETURN alice.DOB AS DateOfBirth",
+    "MATCH (alice:Person {name: $nameParam}) RETURN alice.DOB AS DateOfBirth", 
     {
       nameParam: 'Alice'
-    },
+    }, 
     {
-      routing: 'READ',
+      routing: 'READ', 
       database: 'neo4j'
     }
   )
@@ -320,17 +321,17 @@ executeQueryResultPromise
 ### Auto-Commit/Implicit Transaction
 
 ```javascript
-// This is the most basic and limited form with which to run a Cypher query.
+// This is the most basic and limited form with which to run a Cypher query. 
 // The driver will not automatically retry implicit transactions.
 // This function should only be used when the other driver query interfaces do not fit the purpose.
-// Implicit transactions are the only ones that can be used for CALL { … } IN TRANSACTIONS queries.
+// Implicit transactions are the only ones that can be used for CALL { …​ } IN TRANSACTIONS queries. 
 
 var implicitTxResultPromise = session
   .run(
-    "CALL { … } IN TRANSACTIONS",
+    "CALL { …​ } IN TRANSACTIONS", 
     {
       param1: 'param'
-    },
+    }, 
     {
       database: 'neo4j'
     }
@@ -344,7 +345,7 @@ implicitTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 ### Explicit Transactions
@@ -430,9 +431,11 @@ rxSession
 
 ```javascript
 // Run a Cypher statement, reading the result in a streaming manner as records arrive:
-driver
-  .executeQuery('MERGE (alice:Person {name : $nameParam}) RETURN alice.name AS name', {
-    nameParam: 'Alice'
+session
+  .executeWrite(tx => {
+    return tx.run('MERGE (alice:Person {name : $nameParam}) RETURN alice.name AS name', {
+      nameParam: 'Alice'
+    })
   })
   .subscribe({
     onKeys: keys => {
@@ -472,7 +475,6 @@ driver
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
 ```
 
 #### Consuming Records with Reactive API

packages/neo4j-driver/README.md

@@ -44,7 +44,7 @@ var neo4j = require('neo4j-driver')
 import neo4j from 'neo4j-driver'
 ```
 
-Driver instance should be closed when Node.js application exits:
+Driver instance should be closed when the application exits:
 
 ```javascript
 driver.close() // returns a Promise
@@ -226,7 +226,7 @@ readTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 #### Reading with Reactive Session
@@ -270,7 +270,7 @@ writeTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 #### Writing with Reactive Session
@@ -345,7 +345,7 @@ implicitTxResultPromise
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
+  .finally(() => session.close())
 ```
 
 ### Explicit Transactions
@@ -431,9 +431,11 @@ rxSession
 
 ```javascript
 // Run a Cypher statement, reading the result in a streaming manner as records arrive:
-driver
-  .executeQuery('MERGE (alice:Person {name : $nameParam}) RETURN alice.name AS name', {
-    nameParam: 'Alice'
+session
+  .executeWrite(tx => {
+    return tx.run('MERGE (alice:Person {name : $nameParam}) RETURN alice.name AS name', {
+      nameParam: 'Alice'
+    })
   })
   .subscribe({
     onKeys: keys => {
@@ -473,7 +475,6 @@ driver
   .catch(error => {
     console.log(error)
   })
-  .then(() => session.close())
 ```
 
 #### Consuming Records with Reactive API