chore: improve docs for updating schemas and db error logging

* docs: document how to update database schema

* chore: improve error logging

* Apply suggestions from code review

Co-authored-by: Vasco Santos <santos.vasco10@gmail.com>

Co-authored-by: Vasco Santos <santos.vasco10@gmail.com>

packages/db/postgres/README.md

@@ -65,6 +65,25 @@ Once you are done, the local setup can easily be stopped and cleaned using:
 node scripts/cli.js db --stop --clean --project web3-storage
 ```
 
+### 4. Alter DB schema
+
+In order for your changes to the DB schema to be reflected in Postgres you need to run an `openapi-typescript` script:
+
+```bash
+node scripts/cli.js db-sql
+```
+
+`pg-rest-api-types.ts` stores the types of the various DB tables and their columns.
+In order to get them updated after a change to your db structure you can run:
+
+```bash
+node scripts/cli.js pg-rest-api-types
+```
+
+Do not forget to update `db-client-types.ts` to reflect your changes to the schema.
+
+If you're creating a new table, type or view please remember to update `reset.sql` as well.
+
 ## Database Diagram
 
 ![image](https://user-images.githubusercontent.com/7295071/137729026-50aebb55-e89c-45ed-b636-b3e39cc53cc0.png)

packages/db/scripts/cmds/db.js

@@ -47,7 +47,7 @@ export async function dbCmd ({ project, init, start, stop, clean }) {
 
   if (start) {
     if ((await isPortReachable(5432)) || (await isPortReachable(3000))) {
-      throw new Error('Another docker project already running')
+      throw new Error('Postgres is already running. Please check if you have any docker project or postgres deamon already running.')
     }
 
     await execa('docker-compose', [