update doc content

Author: Machometec

src/app/console/command/command.component.html

@@ -25,7 +25,7 @@ <h3>Command-line syntax</h3>
                <thead>
                   <tr>
                      <th scope="col">Token</th>
-                     <th scope="col">Discription</th>
+                     <th scope="col">Description</th>
                   </tr>
                </thead>
                <tbody>
@@ -86,23 +86,23 @@ <h3>Define commands</h3>
 &lcub;
    public static function main(array $args = [])
    &lcub;
-      // define the root command.
-      $rootcommand = new CommandLine('watch', 'Command-line that displays the time.');
-      $rootcommand->addOption('--version', 'Display the version information.', '-v');
+      // Defines the root command.
+      $rootCommand = new CommandLine('watch', 'Command-line that displays the time.');
+      $rootCommand->addOption('--version', 'Display the version information.', '-v');
 
-      $rootcommand->setHandler(function (object $sender, CommandEventArgs $args): void &lcub;
+      $rootCommand->setHandler(function (object $sender, CommandEventArgs $args): void &lcub;
          $version = $args->get('--version');
          if ($version) &lcub;
-            Console::writeline("watch command-line: v1.0.0");
+            Console::writeLine("watch command-line: v1.0.0");
             return;
          }
 
-         Console::writeline("Try 'watch --help' to get information about the command's usage.");
+         Console::writeLine("Try 'watch --help' to get information about the command's usage.");
       });
 
-      // define the child command.
+      // Defines the child command.
       $subcommand = new CommandLine('time', 'Display the current time');
-      $subcommand->addArgument('timezone', 'Define the time zome');
+      $subcommand->addArgument('timezone', 'Define the time zone');
 
       $subcommand->setHandler(function (object $sender, CommandEventArgs $args): void &lcub;
          $datetime = new DateTime('now');
@@ -111,22 +111,22 @@ <h3>Define commands</h3>
             $datetime->setTimezone(new DateTimeZone($timezone->Value));
          }
 
-         Console::writeline($datetime->format('H:i:s'));
+         Console::writeLine($datetime->format('H:i:s'));
       }
 
-      // add the child command.
-      $rootcommand->addCommand($subcommand);
+      // Adds the child command.
+      $rootCommand->addCommand($subcommand);
 
-      // parse the input, then invoke the command.
-      $rootcommand->invoke($args);
+      // Parsing the input, then invoking the command.
+      $rootCommand->invoke($args);
    }
 }
 </code></pre>
             <blockquote class="alert alert-info">
                <b>Note:</b> You can run your command-line application by executing the bin file of your application <code>./bin/run</code>
             </blockquote>
             <p>
-               In this example, we have renamed the bin files <code>./bin/run</code> and <code>./bin/run.bat</code> to match the name of the root command, and became <code>./bin/watch</code> and <code>./bin/watch.bat</code>
+               In this example, we have renamed the bin files <code>./bin/run</code> and <code>./bin/run.bat</code> to <code>./bin/watch</code> and <code>./bin/watch.bat</code> to match the name of the root command.
             </p>
             <p>
                Now you can execute the command with a given time zone argument to get the current time of that zone.
@@ -138,7 +138,7 @@ <h5>Output</h5>
             <p>
                Or execute the command with the option <code>--version</code> to get the version information.
             </p>
-            <pre><code class="language-shell">./bin/watch --verion</code></pre>
+            <pre><code class="language-shell">./bin/watch --version</code></pre>
             <h5>Output</h5>
             <pre><code class="language-shell">watch command-line: v1.0.0</code></pre>
          </article>

src/app/core/asynchronous/asynchronous.component.html

@@ -21,18 +21,18 @@ <h3>Coroutine Task</h3>
 function readFileAsync(string $path): Task &lcub;
    // Creating and starting the task.
    $task = Task::run(function() use($path) &lcub;
-      $result = null;
       $file = fopen($path, 'r');
-      // Suspend and resume the task while the reading has not finished yet.
-      do &lcub;
-         yield;
-         stream_set_blocking($file, false);
-         $result .= $content = fgets($file);
+      stream_set_blocking($file, false);
+      $result = null;
+      while (!feof($file)) &lcub;
+         // Suspend and resume the task while the reading has not finished yet.
+         $content = yield fread($file, 1024);
          if ($content === false) &lcub;
             // Throws an exception on failure.
             throw new \Exception("Unable to read from the file");
          }
-      } while (!feof($file));
+         $result .= $content;
+      }
 
       fclose($file);
       // Returns a result on success.
@@ -99,8 +99,8 @@ <h3>Async/Await Pattern</h3>
 
 $readJsonAsync = async(function($path): string &lcub;
    $file = new FileStream($path, 'r');
-   // await for the async reading to complete without blocking the outside scope.
-   $json = await($file->readAsync($file->Lenth));
+   // Await for the async reading to complete without blocking the outside scope.
+   $json = await($file->readAsync($file->Length));
    $data = json_decode($json);
 
    $file->close();
@@ -127,7 +127,7 @@ <h3>Async/Await Pattern</h3>
    public async_readJsonAsync(function($path): string
    &lcub;
       $file = new FileStream($path, 'r');
-      $json = await($file->readAsync($file->Lenth));
+      $json = await($file->readAsync($file->Length));
       $data = json_decode($json);
 
       $file->close();

src/app/core/delegates/delegates.component.html

@@ -22,7 +22,7 @@ <h3>Defining the delegate</h3>
 
 class MyDelegate extends Delegate
 &lcub;
-   // Define the delegate signature.
+   // Defining the delegate signature.
    public function myDelegate(array $args): string
    &lcub;
       // The body is left empty.
@@ -40,7 +40,7 @@ <h3>Defining the handler</h3>
 
 class MyHandler
 &lcub;
-   // Define a method with the same signature as the delegate.
+   // Defining a method with the same signature as the delegate.
    public function handle(array $args): string
    &lcub;
       return serialize($args);
@@ -54,17 +54,17 @@ <h3>Using the delegate</h3>
             </p>
             <pre><code class="language-php">&lt;?php
 
-// Register the method 'handle' of the Handler class
+// Associating the method 'handle' of the Handler class to the delegate.
 $myAction = new MyDelegate([new MyHandler(), 'handle']);
 
-// Or register in-line closure function of the same signature
+// Or Associating in-line closure function of the same signature
 $myAction = new MyDelegate(function(array $args): string &lcub;
    return serialize($args);
 });
 
 $args = ['value1', 'value2'];
 
-// Invoke the delegate instance.
+// Invoking the delegate instance.
 $result = $myAction($args);
 </code></pre>
             <br>
@@ -76,7 +76,7 @@ <h4>Multicast Delegate</h4>
 
 $myAction = new MyDelegate();
 
-// register Handlers
+// Associating Handlers
 $myAction[] = [new MyHandler(), 'handle'];
 $myAction[] = function(array $args): string &lcub;
    return json_encode($args);
@@ -107,7 +107,7 @@ <h5>Event Handler</h5>
                <li><b>$args:</b> (<code>DevNet\System\Event\EventArgs</code>) represents the event arguments to be handled by the handler.</li>
             </ul>
             <p>
-               The example below represents a <code>Button</code> class as a publisher with two events: The <code>click</code> and <code>keypress</code> events, which can be associated with event listners.
+               The example below represents a <code>Button</code> class as a publisher with two events: The <code>click</code> and <code>keypress</code> events, which can be associated with event listeners.
             </p>
             <pre><code class="language-php">&lt;?php
 
@@ -129,7 +129,7 @@ <h5>Event Handler</h5>
       $this->keypress = new EventHandler();
    }
 
-   public function addListner(string $event, callable $handler): void
+   public function addListener(string $event, callable $handler): void
    &lcub;
       switch($event) &lcub;
          case 'click':
@@ -173,7 +173,7 @@ <h5>Event Handler</h5>
       $this->Title = $title;
       $this->MyButton = new Button("My button");
       // Subscribe to the click event.
-      $this->MyButton->addListner('click', [$this, 'onMyButtonClick']);
+      $this->MyButton->addListener('click', [$this, 'onMyButtonClick']);
    }
 
    public function onMyButtonClick(object $sender, EventArgs $event): void

src/app/core/extension/extension.component.html

@@ -64,7 +64,7 @@ <h3>Calling the extension method</h3>
 $employee->Salary = 25000;
 $tax = 0.15;
 
-// calling the extension method as if it belongs to the employee instance.
+// Calling the extension method as if it belongs to the employee instance.
 $income = $employee->getIncome($tax);
 
 print("Income: &lcub;$income}$"); // Income: 21250$

src/app/core/generics/generics.component.html

@@ -33,7 +33,7 @@ <h3>Generic type parameter</h3>
 use DevNet\System\Template;
 use DevNet\System\TypeTrait;
 
-// Define the type parameter T as a type of the items in the collection.
+// Defines the type parameter T as a type of the items in the collection.
 #[Template('T')]
 class Collection implements IEnumerable
 &lcub;
@@ -49,7 +49,7 @@ <h3>Generic type parameter</h3>
 
    private function add(#[Type('T')] $item): void
    &lcub;
-      // Call the item wrapper as collable to get the item value.
+      // Checking the the type of the arguments before using them.
       $this->checkArgumentTypes(func_get_args());
       $this->items[] = $item;
    }
@@ -102,7 +102,7 @@ <h3>Checking generic type</h3>
 
    private Collection $employees;
 
-   // accept only the injection of an argument of type Collection&lt;Employee>
+   // Accepting only the injection of an argument of type Collection&lt;Employee>
    public function __construct(#[Type(Collection::class, [Employee::class])] $employees)
    &lcub;
       $this->checkArgumentTypes(func_get_args());

src/app/core/linq/linq.component.html

@@ -22,13 +22,13 @@ <h3>Using LINQ extension methods</h3>
             </p>
             <pre><code class="language-php">&lt;?php
 
-// declaring the Linq namespace to be able to use the extension methods with the ArrayList instance.
+// Declaring the Linq namespace to be able to use the extension methods with the ArrayList instance.
 use DevNet\System\Linq;
 
-// creating ArrayList instance with generic type argument of Employee class.
+// Creating ArrayList instance with generic type argument of Employee class.
 $list = new ArrayList(Employee::class);
 
-// assuming we have Employee class with constructor that initializes Id and Name properties.
+// Assuming we have Employee class with constructor that initializes Id and Name properties.
 $list[] = new Employee(1, 'bob');
 $list[] = new Employee(2, 'carol');
 $list[] = new Employee(3, 'ted');
@@ -48,7 +48,7 @@ <h6>Output:</h6>
 Last employee is ted with Id 6
 </code></pre>
             <br>
-            <h5>Filtring</h5>
+            <h5>Filtering</h5>
             <pre><code class="language-php">print("Employees with Id greater than 2\n");
 
 $employees = $list->where(fn($employee) => $employee->Id > 2);
@@ -111,7 +111,7 @@ <h6>Output:</h6>
 </code></pre>
             <br>
             <h5>Paging</h5>
-            <pre><code class="language-php">// skip first 2 employees then take just 3 from the rest of employees.
+            <pre><code class="language-php">// Skips the first 2 employees then take just 3 from the rest of employees.
 $employees = $list->skip(2)->take(3);
 
 foreach ($employees as $employee) &lcub;
@@ -129,18 +129,18 @@ <h5>Aggregating</h5>
 $max   = $list->max(fn($employee) => $employee->Id);
 $min   = $list->min(fn($employee) => $employee->Id);
 
-print("Tolat employess => &lcub;$count}\n");
+print("Total employees => &lcub;$count}\n");
 print("Max employee Id => &lcub;$max}\n");
 print("Min employee Id => &lcub;$min}\n");
 </code></pre>
             <h6>Output:</h6>
-            <pre><code class="language-shell">Tolat employess => 6
+            <pre><code class="language-shell">Total employees => 6
 Max employee Id => 6
 Min employee Id => 1
 </code></pre>
             <br>
             <h5>Grouping</h5>
-            <pre><code class="language-php">// create groups of employees share the same name.
+            <pre><code class="language-php">// Creates a groups of employees share the same name.
 $groups = $list->groupBy(fn($employee) => $employee->Name);
 
 foreach ($groups as $group) &lcub;

src/app/entity/query/query.component.html

@@ -46,7 +46,7 @@ <h3>Linq Query</h3>
                <code>EntitySet</code> implements the <code>IQueryable</code> interface so it can use LINQ (Language-Integrated Query) to query data from the database, which are chained methods that represent SQL operations, compiled by the database provider to be sent as a specific database query language (MySQL, SQLite, ...) and then to get the result set.
             </p>
             <blockquote class="alert alert-warning">
-               <b>Importante:</b> Linq methods are extension methods, so to use this feature, you have to declare the use of the Linq namespace <code>DevNet\System\Linq</code> in every class or code that uses Linq methods with an instance of <code>EntitySet</code>.
+               <b>Important:</b> Linq methods are extension methods, so to use this feature, you have to declare the use of the Linq namespace <code>DevNet\System\Linq</code> in every class or code that uses Linq methods with an instance of <code>EntitySet</code>.
             </blockquote>
             <br>
             <h4>Filtering Data</h4>

src/app/entity/start/start.component.html

@@ -185,7 +185,7 @@ <h4>Connection String</h4>
                <code>"//[username]:[password]@[host]:[port]/[database]?[option=value]"</code>
             </p>
             <br>
-            <h3>Registing the EntityContext</h3>
+            <h3>Registering the EntityContext</h3>
             <p>
                You can register Entity ORM as a reused service that will be injected into your application using the Extension method <code>ServiceCollectionExtensions::addEntityContext()</code> inside the method <code>WebHostBuilder::register()</code>, as shown in the following code example:
             </p>
@@ -226,6 +226,7 @@ <h3>Registing the EntityContext</h3>
 
 use DevNet\Web\Endpoint\ActionController;
 use DevNet\Web\Endpoint\IActionResult;
+use DevNet\Web\Endpoint\Route;
 use Application\Models\BlogContext;
 
 class BlogController extends ActionController
@@ -237,9 +238,10 @@ <h3>Registing the EntityContext</h3>
       $this->blog = $blog;
    }
 
+   #[Route("/")]
    public function index(): IActionResult
    &lcub;
-      $this->view($this->blog->Posts);
+      $this->view(['posts' => $this->blog->Posts]);
    }
 }
 </code></pre>

src/app/security/antiforgery/antiforgery.component.html

@@ -74,9 +74,9 @@ <h3>X-CSRF-TOKEN</h3>
             <p>
                After registering the Antiforgery service with the MVC web application, it will be injected into the view so that you can generate a token in the HTML form.
             </p>
-            <pre><code class="language-php-template">&lt;form method="POST" action="/account/update/<?= $model->Id ?>">
-   &lt;input type="text" name="username value="<?= $model->Username ?>" />
-   &lt;input type="email" name="email" value="<?= $model->Email ?>" />
+            <pre><code class="language-php-template">&lt;form method="POST" action="/account/update/<?= $user->Id ?>">
+   &lt;input type="text" name="username value="<?= $user->Username ?>" />
+   &lt;input type="email" name="email" value="<?= $user->Email ?>" />
    &lt;input type="hidden" name="X-CSRF-TOKEN" value="<?= $this->Antiforgery->getToken() ?>" />
 &lt;/form>
 </code></pre>
@@ -108,10 +108,10 @@ <h3>X-CSRF-TOKEN</h3>
       if (!$user) &lcub;
          Throw \Exception("page not found!", 404);
       }
-      return $this->view($user);
+      return $this->view(['user' => $user]);
    }
 
-   // add AntiForgery validation filter as an attribute.
+   // Adds AntiForgery validation filter as an attribute.
    #[Validate]
    #[Route(path: '/account/update/&lcub;id}', method: 'POST')]
    public function update(int $id, User $form): IActionResult
@@ -158,7 +158,7 @@ <h3>X-XSRF-TOKEN</h3>
    }));
 
    $routes.MapPost("/account/store", (function(HttpContext $context) &lcub;
-      $form = $context->Resquest->Form;
+      $form = $context->Request->Form;
       $user = new User();
       $user->Username = $form->getValue('username');
       $user->Password = password_hash($form->getValue('password'), PASSWORD_DEFAULT);
@@ -171,7 +171,7 @@ <h3>X-XSRF-TOKEN</h3>
       file_put_contents('path/to/data.json', $json);
       $context->Response->setStatusCode(200);
    })
-   // add Antiforgery validation filter to the endpoint "/account/store".
+   // Adds Antiforgery validation filter to the endpoint "/account/store".
    ->addFilter(Validate::class);
 });</code></pre>
             <p>