gpt: Automated pattern documentation updates

Author: nicklem

docs/description/CakePHP_Classes_ReturnTypeHint.md

@@ -1 +1,14 @@
-Classes: Return Type Hint
+Enforce explicit return type hints in CakePHP classes to enhance code reliability and readability. Adopting this practice improves debugging and IDE support. For example:
+```php
+// Before
+public function getName() {
+    return $this->name;
+}
+
+// After
+public function getName(): string {
+    return $this->name;
+}
+```
+
+<!-- Codacy PatPatBot reviewed: 2024-05-23T16:29:07.337Z -->

docs/description/CakePHP_Commenting_DocBlockAlignment.md

@@ -1 +1,14 @@
-Commenting: Doc Block Alignment
+Maintain consistent and readable PHPDoc comments across the codebase using alignment guidelines. This aids in auto-generation of documentation and facilitates easier code maintenance.
+
+Example:
+```php
+/**
+ * Retrieves user data.
+ *
+ * @param int    $id   User ID.
+ * @param string $type Data type.
+ * @return array User data array.
+ */
+```
+
+<!-- Codacy PatPatBot reviewed: 2024-05-23T16:29:37.357Z -->

docs/description/CakePHP_Commenting_FunctionComment.md

@@ -1 +1,14 @@
-Commenting: Function Comment
+Ensure all functions are documented with PHPDoc for better readability, automatic documentation, and IDE support. For example:
+```php
+/**
+ * Retrieves user data.
+ *
+ * @param int $userId The ID of the user.
+ * @return array The user data.
+ */
+public function getUserData($userId) {
+    // function logic
+}
+```
+
+<!-- Codacy PatPatBot reviewed: 2024-05-23T16:30:01.132Z -->