- update code samples

Author: Isaac Ramirez

docs/samples/ex-x.x.x.js

@@ -1,34 +1,49 @@
-/** @module samples */
+/** @module Exercises */
 
 const { StdOut } = require('../../src/libs')
 
 /**
- * @summary Exercise x.x.x
+ * Exercise C1S1E1
+ * @memberof module:Exercises
  */
-class Exercise {
+class C1S1E1 {
   /**
-   * Code solution for Exercise x.x.x
-   * @param {[number, number]} args - [x, y]
-   * @example <caption>example 1</caption>
-   * ```shell
+   * Exercise solution.
+   * @note Keep the `solution` method as the first one
+   * so that it is easier to look at the examples.
+   * Feel free to remove this note.
+   * @example <caption>Multiplying 0.5 * 0.9</caption>
+   * {@lang bash}
    * $ node ex-x.x.x.js 0.5 0.9
    * x: 0.5
    * y: 0.9
    * x * y = 0.45
-   * ```
+   * @param {...string} args - Params: `[x, y]`
+   * * @type {number} `args[0]` - Number `x`.
+   * * @type {number} `args[1]` - Number `y`.
    */
   static solution (args) {
     const x = parseFloat(args[0])
     const y = parseFloat(args[1])
 
     StdOut.println('x:', x)
     StdOut.println('y:', y)
-    StdOut.println('x * y =', parseFloat(x) * parseFloat(y))
+    StdOut.println('x * y =', x * y)
+  }
+
+  /**
+   * Other methods go after `solution` method.
+   */
+  static otherMethod () {
+    // code goes here
   }
 }
 
-module.exports = Exercise
+// Exports
+// ==============================
+
+module.exports = C1S1E1
 
-// Execution
+// Bash Execution
 // ==============================
-if (require.main === module) Exercise.solution(process.argv.slice(2))
+if (require.main === module) C1S1E1.solution(process.argv.slice(2))

docs/samples/test.client.js

@@ -10,24 +10,28 @@ const { StdOut } = require('../../src/libs')
  */
 class TestClient {
   /**
-   * Main static function
-   * @param {Array<string>} args - Syntax: `[n, m]`
-   * * The first number `n`
-   * * The second number `m`
-   * @returns {number} `n` * `m`
-   * @example <caption>testing the client</caption>
+   * Outputs the multiplication of `n * m`.
+   * @example <caption>Multiplying 10 * 50</caption>
    * {@lang bash}
    * $ ./client TestClient 10 50
    * 500
+   * @param {...string} args - Params: `[n, m]`
+   * * @type {number} `args[0]` - Number `n`.
+   * * @type {number} `args[1]` - Number `m`.
    */
   static main (args) {
     const n = parseInt(args[0])
     const m = parseInt(args[1])
 
     StdOut.println(n * m)
   }
-}
 
-TestClient.main()
+  /**
+   * Other methods go after `main` method.
+   */
+  static otherMethod () {
+    // your code goes here
+  }
+}
 
 module.exports = { TestClient }