docs: update and improve README and README.pt-br.md files for better clarity and structure

Author: walmir-silva

README.md

@@ -1,11 +1,8 @@
 # KaririCode Framework: Dotenv Component
 
-[![en](https://img.shields.io/badge/lang-en-red.svg)](README.md)
-[![pt-br](https://img.shields.io/badge/lang-pt--br-green.svg)](README.pt-br.md)
+[![en](https://img.shields.io/badge/lang-en-red.svg)](README.md) [![pt-br](https://img.shields.io/badge/lang-pt--br-green.svg)](README.pt-br.md)
 
-![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white)
-![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
-![PHPUnit](https://img.shields.io/badge/PHPUnit-3776AB?style=for-the-badge&logo=php&logoColor=white)
+![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white) ![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white) ![PHPUnit](https://img.shields.io/badge/PHPUnit-3776AB?style=for-the-badge&logo=php&logoColor=white)
 
 A robust and flexible environment variable management component for the KaririCode Framework, providing advanced features for handling .env files in PHP applications.
 

README.pt-br.md

@@ -1,31 +1,28 @@
 # KaririCode Framework: Componente Dotenv
 
-[![en](https://img.shields.io/badge/lang-en-red.svg)](README.md)
-[![pt-br](https://img.shields.io/badge/lang-pt--br-green.svg)](README.pt-br.md)
+[![en](https://img.shields.io/badge/lang-en-red.svg)](README.md) [![pt-br](https://img.shields.io/badge/lang-pt--br-green.svg)](README.pt-br.md)
 
-![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white)
-![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white)
-![PHPUnit](https://img.shields.io/badge/PHPUnit-3776AB?style=for-the-badge&logo=php&logoColor=white)
+![PHP](https://img.shields.io/badge/PHP-777BB4?style=for-the-badge&logo=php&logoColor=white) ![Docker](https://img.shields.io/badge/Docker-2496ED?style=for-the-badge&logo=docker&logoColor=white) ![PHPUnit](https://img.shields.io/badge/PHPUnit-3776AB?style=for-the-badge&logo=php&logoColor=white)
 
-Um componente robusto e flexível para gerenciamento de variáveis de ambiente do KaririCode Framework, fornecendo recursos avançados para manipulação de arquivos .env em aplicações PHP.
+Um componente robusto e flexível para gerenciamento de variáveis de ambiente no KaririCode Framework, fornecendo recursos avançados para lidar com arquivos .env em aplicações PHP.
 
-## Características
+## Funcionalidades
 
-- Análise e carregamento de variáveis de ambiente a partir de arquivos .env
+- Parse e carregamento de variáveis de ambiente a partir de arquivos .env
 - Suporte para interpolação de variáveis
 - **Detecção e conversão automática de tipos**
   - Detecta e converte tipos comuns (string, inteiro, float, booleano, array, JSON)
-  - Preserva os tipos de dados para uso mais preciso em sua aplicação
+  - Preserva tipos de dados para uso mais preciso em sua aplicação
 - **Sistema de tipos personalizável**
   - Extensível com detectores e conversores de tipos personalizados
   - Controle refinado sobre como suas variáveis de ambiente são processadas
 - Modo estrito para validação de nomes de variáveis
-- Fácil acesso às variáveis de ambiente através de uma função auxiliar global
+- Acesso fácil às variáveis de ambiente por meio de uma função auxiliar global
 - Suporte para estruturas de dados complexas (arrays e JSON) em variáveis de ambiente
 
 ## Instalação
 
-Para instalar o componente Dotenv do KaririCode em seu projeto, execute o seguinte comando:
+Para instalar o componente Dotenv do KaririCode no seu projeto, execute o seguinte comando:
 
 ```bash
 composer require kariricode/dotenv
@@ -46,10 +43,10 @@ KARIRI_APP_DEBUG=true
 KARIRI_APP_URL=https://kariricode.com
 KARIRI_MAIL_FROM_NAME="${KARIRI_APP_NAME}"
 KARIRI_JSON_CONFIG={"key": "value", "nested": {"subkey": "subvalue"}}
-KARIRI_ARRAY_CONFIG=["item1", "item2", "item com espaços"]
+KARIRI_ARRAY_CONFIG=["item1", "item2", "item with spaces"]
 ```
 
-2. No arquivo de inicialização da sua aplicação:
+2. No arquivo de bootstrap da sua aplicação:
 
 ```php
 <?php
@@ -84,28 +81,28 @@ O componente Dotenv do KaririCode detecta e converte automaticamente os seguinte
 Exemplo:
 
 ```env
-STRING_VAR=Olá Mundo
+STRING_VAR=Hello World
 INT_VAR=42
 FLOAT_VAR=3.14
 BOOL_VAR=true
 NULL_VAR=null
 ARRAY_VAR=["item1", "item2", "item3"]
-JSON_VAR={"chave": "valor", "aninhado": {"subchave": "subvalor"}}
+JSON_VAR={"key": "value", "nested": {"subkey": "subvalue"}}
 ```
 
-Quando acessadas usando a função `env()`, estas variáveis serão automaticamente convertidas para seus tipos PHP apropriados:
+Quando acessadas usando a função `env()`, essas variáveis serão automaticamente convertidas para seus tipos PHP apropriados:
 
 ```php
-$stringVar = env('STRING_VAR'); // string: "Olá Mundo"
+$stringVar = env('STRING_VAR'); // string: "Hello World"
 $intVar = env('INT_VAR');       // inteiro: 42
 $floatVar = env('FLOAT_VAR');   // float: 3.14
 $boolVar = env('BOOL_VAR');     // booleano: true
 $nullVar = env('NULL_VAR');     // null
 $arrayVar = env('ARRAY_VAR');   // array: ["item1", "item2", "item3"]
-$jsonVar = env('JSON_VAR');     // array: ["chave" => "valor", "aninhado" => ["subchave" => "subvalor"]]
+$jsonVar = env('JSON_VAR');     // array: ["key" => "value", "nested" => ["subkey" => "subvalue"]]
 ```
 
-Esta tipagem automática garante que você esteja trabalhando com os tipos de dados corretos em sua aplicação, reduzindo erros relacionados a tipos e melhorando a confiabilidade geral do código.
+Essa tipagem automática garante que você esteja trabalhando com os tipos corretos em sua aplicação, reduzindo erros relacionados a tipos e melhorando a confiabilidade geral do código.
 
 ### Uso Avançado
 
@@ -116,18 +113,18 @@ Crie detectores de tipo personalizados para lidar com formatos específicos:
 ```php
 use KaririCode\Dotenv\Type\Detector\AbstractTypeDetector;
 
-class DetectorPersonalizado extends AbstractTypeDetector
+class CustomDetector extends AbstractTypeDetector
 {
     public const PRIORITY = 100;
 
     public function detect(mixed $value): ?string
     {
         // Sua lógica de detecção aqui
-        // Retorne o tipo detectado como uma string, ou null se não for detectado
+        // Retorne o tipo detectado como uma string, ou null se não detectado
     }
 }
 
-$dotenv->addTypeDetector(new DetectorPersonalizado());
+$dotenv->addTypeDetector(new CustomDetector());
 ```
 
 #### Conversores de Tipo Personalizados
@@ -137,20 +134,20 @@ Crie conversores de tipo personalizados para lidar com tipos de dados específic
 ```php
 use KaririCode\Dotenv\Contract\TypeCaster;
 
-class ConversorPersonalizado implements TypeCaster
+class CustomCaster implements TypeCaster
 {
     public function cast(mixed $value): mixed
     {
         // Sua lógica de conversão aqui
     }
 }
 
-$dotenv->addTypeCaster('tipo_personalizado', new ConversorPersonalizado());
+$dotenv->addTypeCaster('custom_type', new CustomCaster());
 ```
 
 ## Desenvolvimento e Testes
 
-Para fins de desenvolvimento e testes, este pacote usa Docker e Docker Compose para garantir consistência em diferentes ambientes. Um Makefile é fornecido para facilitar a execução de comandos.
+Para fins de desenvolvimento e teste, este pacote utiliza Docker e Docker Compose para garantir consistência entre diferentes ambientes. Um Makefile é fornecido para conveniência.
 
 ### Pré-requisitos
 
@@ -173,7 +170,7 @@ Para fins de desenvolvimento e testes, este pacote usa Docker e Docker Compose p
    make setup-env
    ```
 
-3. Inicie os contêineres Docker:
+3. Inicie os containers Docker:
 
    ```bash
    make up
@@ -187,23 +184,23 @@ Para fins de desenvolvimento e testes, este pacote usa Docker e Docker Compose p
 ### Comandos Make Disponíveis
 
 - `make up`: Inicia todos os serviços em segundo plano
-- `make down`: Para e remove todos os contêineres
+- `make down`: Para e remove todos os containers
 - `make build`: Constrói as imagens Docker
-- `make shell`: Acessa o shell do contêiner PHP
+- `make shell`: Acessa o shell do container PHP
 - `make test`: Executa os testes
 - `make coverage`: Executa a cobertura de testes com formatação visual
 - `make cs-fix`: Executa o PHP CS Fixer para corrigir o estilo do código
 - `make quality`: Executa todos os comandos de qualidade (cs-check, test, security-check)
 
-Para uma lista completa dos comandos disponíveis, execute:
+Para uma lista completa de comandos disponíveis, execute:
 
 ```bash
 make help
 ```
 
 ## Licença
 
-Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
+Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para mais detalhes.
 
 ## Suporte e Comunidade
 
@@ -214,15 +211,8 @@ Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICE
 ## Agradecimentos
 
 - A equipe do KaririCode Framework e contribuidores.
-- Inspirado por outras bibliotecas PHP Dotenv populares.
+- Inspirado por outras bibliotecas populares de Dotenv para PHP.
 
 ---
 
-## Agradecimentos
-
-- A equipe do KaririCode Framework e contribuidores.
-- Inspirado por outras bibliotecas PHP Dotenv populares.
-
----
-
-Construído com ❤️ pela equipe KaririCode. Capacitando desenvolvedores para construir aplicações PHP mais robustas e flexíveis.
+Construído com ❤️ pela equipe KaririCode. Capacitando desenvolvedores a criar aplicações PHP mais robustas e flexíveis.