Update inline documentation for consistency and clarity. Adjust code formatting, correct typos, and expand usage examples for better readability.

Author: jturbide

phpdoc.xml

@@ -18,10 +18,10 @@
             </source>
             <ignore hidden="true" symlinks="true">
                 <path>tests/**/*</path>
-                <path>vendor/**/*</path>
             </ignore>
         </api>
     </version>
-    
+
     <template name="vendor/saggre/phpdocumentor-markdown/themes/markdown"/>
+    <setting name="template.urlFileExtensions" value="yes" />
 </phpdocumentor>

src/Mvc/Model.php

@@ -37,7 +37,7 @@
  * - onValidationFails
  * - prepareSave
  * - validation
- * @link https://docs.phalcon.io/5.6/db-models/#events
+ * @link https://docs.phalcon.io/5.9/db-models/#events
  *
  * {@inheritdoc} \Phalcon\Mvc\Model
  * @package Zemit\Mvc

src/Mvc/Model/Traits/EagerLoad.php

@@ -26,9 +26,9 @@ abstract public static function find($parameters = null);
     abstract public static function findFirst($parameters = null);
 
     /**
-     * <code>
-     * <?php
+     * Example:
      *
+     * ```php
      * $limit = 100;
      * $offset = max(0, $this->request->getQuery('page', 'int') - 1) * $limit;
      *
@@ -41,8 +41,7 @@ abstract public static function findFirst($parameters = null);
      *         foreach ($robot->parts as $part) { ... }
      *     }
      * }
-     *
-     * </code>
+     * ```
      *
      * @param array ...$arguments
      */
@@ -169,17 +168,17 @@ protected static function findWithBy(string $forwardMethod, array $arguments): ?
     }
 
     /**
-     * <code>
+     * Example:
      *
+     * ```php
      * $manufacturer = Manufacturer::findFirstById(51);
      *
      * $manufacturer->load('Robots.Parts');
      *
      * foreach ($manufacturer->robots as $robot) {
      *    foreach ($robot->parts as $part) { ... }
      * }
-     *
-     * </code>
+     * ```
      *
      * @param array ...$arguments
      * @return ?ModelInterface

src/Support/Helper/Str/SanitizeUTF8.php

@@ -23,7 +23,7 @@ class SanitizeUTF8
      * converting it to UTF-8, and removing invalid UTF-8 characters.
      *
      * @param string $string The input string to be sanitized.
-     * @param string $invalidUtf8Regex A regular expression pattern to identify invalid UTF-8 characters. Default: '[^\x20-\x7E\xA0-\xFF]'.
+     * @param string $invalidUtf8Regex A regular expression pattern to identify invalid UTF-8 characters. Default: '[^\\x20-\\x7E\\xA0-\\xFF]'.
      * @return string The sanitized string in UTF-8 encoding, with invalid characters removed.
      */
     public function __invoke(string $string, string $invalidUtf8Regex = '[^\x20-\x7E\xA0-\xFF]'): string