Update README.md

Author: regadas

.gitignore

@@ -3,6 +3,7 @@
 .log
 dist
 docs
+*.tmp
 
 .yarn/*
 !.yarn/patches

README.md

@@ -23,20 +23,45 @@ A [Trino](https://trino.io) client for [Node.js](https://nodejs.org/).
 
 ## Usage
 
+For additional info on all available methods and types have a look at the `API` docs [here](https://regadas.dev/trino-js-client).
+
+### Create a Trino client
+
 ```typescript
-const trino = Trino.create({
-  server: 'http://localhost:8080'
+const trino: Trino = Trino.create({
+  server: 'http://localhost:8080',
   catalog: 'tpcds',
   schema: 'sf100000',
   auth: new BasicAuth('test'),
 });
+```
+
+### Submit a query
+
+```typescript
+const iter: Iterator<QueryResult> = await trino.query(
+  'select * from customer limit 100'
+);
+```
 
-const iter = await trino.query('select * from customer limit 100');
-const data = await iter
+### Iterate through the query results
+
+```typescript
+for await (const queryResult of iter) {
+  console.log(queryResult.data);
+}
+```
+
+### Alternative: map and aggregate the data
+
+```typescript
+const data: QueryData[] = await iter
   .map(r => r.data ?? [])
   .fold<QueryData[]>([], (row, acc) => [...acc, ...row]);
 ```
 
+## Examples
+
 More usage [examples](https://github.com/regadas/trino-js-client/blob/main/tests/it/client.spec.ts) can be found in the [integration tests](https://github.com/regadas/trino-js-client/blob/main/tests/it/client.spec.ts).
 
 Filipe Regadas (regadas) 2022