Clarify example

lib/cartodb/utils/phased-execution.js

@@ -16,17 +16,18 @@
  *     let p = new PhasedExecution();
  *     // Define first phase with tasks 1 & 2
  *     p.phase(() => {
+ *         console.log('At phase I', p.results);*
  *         p.results.phase1 = 1
  *         p.task(new Promise((resolve) => {
  *             setTimeout( () => {
- *                 console.log('At 1:', p.results);
+ *                 console.log('At task 1:', p.results);
  *                 p.results.task1 = 100;
  *                 resolve();
  *             }, 400);
  *         }));
  *         p.task(new Promise((resolve) => {
  *             setTimeout( () => {
- *                 console.log('At 2:', p.results);
+ *                 console.log('At task 2:', p.results);
  *                 p.results.task2 = 200;
  *                 resolve();
  *             }, 100);
@@ -34,17 +35,18 @@
  *     });
  *     // Define second phase with tasks 3 & 4
  *     p.phase(() => {
+ *         console.log('At phase II', p.results);
  *         p.results.phase2 = 2
  *         p.task(new Promise((resolve) => {
  *             setTimeout( () => {
- *                 console.log('At 3:', p.results);
+ *                 console.log('At task 3:', p.results);
  *                 p.results.task3 = 300;
  *                 resolve();
  *             }, 50);
  *         }));
  *         p.task(new Promise((resolve) => {
  *             setTimeout( () => {
- *                 console.log('At 4:', p.results);
+ *                 console.log('At task 4:', p.results);
  *                 p.results.task4 = 400;
  *                 resolve();
  *             }, 100);
@@ -52,18 +54,21 @@
  *     });
  *     // Define third phase with task 5
  *     p.phase(() => {
+ *         console.log('At phase III', p.results);
  *         p.results.phase3 = 3
  *         p.task(new Promise((resolve) => {
  *             setTimeout( () => {
- *                 console.log('At 5:', p.results);
+ *                 console.log('At task 5:', p.results);
  *                 p.results.task5 = 500;
  *                 resolve();
  *             }, 50);
  *         }));
  *     });
  *     // Execute all tasks
- *     p.run(() => {
- *         console.log("RESULTS:", p.results);
+ *     p.run((results) => {
+ *         console.log("RESULTS:", results);
+ *     }).catch((err) => {
+ *         console.log("ERROR:", error);
  *     });
  */
 module.exports = class PhasedExecution {
@@ -88,4 +93,3 @@ module.exports = class PhasedExecution {
         }
     }
 };
-// TODO: error handling