fix(documentation): Refactored readme for clarity and consistency, fixed documentation typos

ts/classes.portproxy.ts

@@ -663,7 +663,7 @@ export class PortProxy {
       const checkInterval = setInterval(() => {
         if (this.connectionRecords.size === 0) {
           clearInterval(checkInterval);
-          resolve();
+          resolve(); // lets resolve here as early as we reach 0 remaining connections
         }
       }, 1000);