Add docs. (#4)

Author: terabytesoftw

README.md

@@ -2,7 +2,7 @@
     <a href="https://github.com/php-forge/helpers" target="_blank">
         <img src="https://avatars.githubusercontent.com/u/103309199?s%25253D400%252526u%25253Dca3561c692f53ed7eb290d3bb226a2828741606f%252526v%25253D4" height="100px">
     </a>
-    <h1 align="center">Collection of Helpers for PHP.</h1>
+    <h1 align="center">Collection of Helper for PHP.</h1>
     <br>
 </p>
 
@@ -45,7 +45,71 @@ or add
 
 ## Usage
 
-[Check the documentation docs](/docs/README.md) to learn about usage.
+The repository contains a collection of utility functions designed to simplify common programming tasks in PHP.
+
+Whether you're working on web development, data processing, or other projects, these helper functions can save you time
+and effort.
+
+## Converts a camelCase formatted string to snake_case
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Helper\WordFormatter;
+
+$word = WordFormatter::camelCaseToSnakeCase('date_birth');
+```
+
+## Convert a snake_case formatted string to camelCase
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Helper\WordFormatter;
+
+$word = WordFormatter::snakeCaseToCamelCase('date_birth');
+```
+
+##  Converts a string to words with capitalized first letters
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Helper\WordFormatter;
+
+$word = WordFormatter::capitalizeToWords('Date Birth');
+```
+
+## Generate ramdon pasword
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Helper\Password;
+
+$password = Password::generate(8);
+```
+
+
+## Get all timezones
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Helper\Timezone;
+
+$timezones = Timezone::getAll();
+```
 
 ## Testing
 

composer.json

@@ -1,10 +1,10 @@
 {
-    "name": "php-forge/helpers",
+    "name": "php-forge/helper",
     "type": "library",
-    "description": "Collection of Helpers for PHP.",
+    "description": "Collection of Helper for PHP.",
     "keywords": [
         "php-forge",
-        "helpers"
+        "helper"
     ],
     "license": "mit",
     "require": {
@@ -19,12 +19,12 @@
     },
     "autoload": {
         "psr-4": {
-            "PHPForge\\Helpers\\": "src"
+            "PHPForge\\Helper\\": "src"
         }
     },
     "autoload-dev": {
         "psr-4": {
-            "PHPForge\\Helpers\\Tests\\": "tests"
+            "PHPForge\\Helper\\Tests\\": "tests"
         }
     },
     "extra": {

src/Password.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers;
+namespace PHPForge\Helper;
 
 use function array_map;
 use function implode;

src/TimeZone.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers;
+namespace PHPForge\Helper;
 
 use DateTime;
 use DateTimeZone;

src/WordFormatter.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers;
+namespace PHPForge\Helper;
 
 use function explode;
 use function implode;

tests/PasswordTest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers\Tests;
+namespace PHPForge\Helper\Tests;
 
-use PHPForge\Helpers\Password;
+use PHPForge\Helper\Password;
 use PHPUnit\Framework\TestCase;
 
 final class PasswordTest extends TestCase

tests/TimeZoneTest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers\Tests;
+namespace PHPForge\Helper\Tests;
 
-use PHPForge\Helpers\TimeZone;
+use PHPForge\Helper\TimeZone;
 use PHPUnit\Framework\TestCase;
 
 final class TimeZoneTest extends TestCase
@@ -41,12 +41,12 @@ public function testGetAllReturnsOrderedTimeZones()
         $prevOffset = null;
 
         foreach ($timeZones as $timeZone) {
-            // Verifica que el offset sea mayor o igual al offset anterior
+            // verify that the offset is greater than or equal to the previous offset
             if ($prevOffset !== null) {
                 $this->assertGreaterThanOrEqual($prevOffset, $timeZone['offset']);
             }
 
-            // Verifica que el array tenga las claves correctas
+            // verify that the array contains the expected keys
             $this->assertArrayHasKey('timezone', $timeZone);
             $this->assertArrayHasKey('name', $timeZone);
             $this->assertArrayHasKey('offset', $timeZone);

tests/WordFormatterTest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PHPForge\Helpers\Tests;
+namespace PHPForge\Helper\Tests;
 
-use PHPForge\Helpers\WordFormatter;
+use PHPForge\Helper\WordFormatter;
 use PHPUnit\Framework\TestCase;
 
 final class WordFormatterTest extends TestCase