translation into Brazilian Portuguese and corrections in the English …

.github/CONTRIBUTING.md

@@ -22,25 +22,25 @@ If you are only going to make a pull request in a single repository, simply crea
 
 if you are going to make a pull request in multiple repositories, create a **new branch with the same name in all repositories**, this allows our github actions workflow to sync all branches, and tests to run correctly.
 
-5. [Check your changes](/docs/en/testing.md).
+5. [Check your changes](/docs/guide/en/testing.md).
 
 ## Reporting issues
 
 Please follow the guidelines below when creating an issue so that your issue can be more promptly resolved:
 
-* Provide information including: the version of PHP, dbms and the type of operating system.
-* Provide the **complete** error call stack if available. A screenshot to explain the issue is very welcome.
-* Describe the steps for reproducing the issue. It would be even better if you could provide code to reproduce the issue.
-* If possible you may even create a failing unit test and [send it as a pull request](#git-workflow).
+- Provide information including: the version of PHP, dbms and the type of operating system.
+- Provide the **complete** error call stack if available. A screenshot to explain the issue is very welcome.
+- Describe the steps for reproducing the issue. It would be even better if you could provide code to reproduce the issue.
+- If possible you may even create a failing unit test and [send it as a pull request](#git-workflow).
 
 If the issue is related to one of the dbms packages, please report it to the corresponding repository.
 
 If you are unsure, [report it to the main repository](https://github.com/yiisoft/db/issues/new) (<https://github.com/yiisoft/db/issues>).
 
 **Do not report an issue if**
 
-* you are asking how to use some **Yii DB** feature. You should use [the forum](https://forum.yiiframework.com/c/yii-3-0/63) or [telegram](https://t.me/yii3en) for this purpose.
-* your issue is about security. Please [contact us directly](https://www.yiiframework.com/security/) to report security issues.
+- you are asking how to use some **Yii DB** feature. You should use [the forum](https://forum.yiiframework.com/c/yii-3-0/63) or [telegram](https://t.me/yii3en) for this purpose.
+- your issue is about security. Please [contact us directly](https://www.yiiframework.com/security/) to report security issues.
 
 **Avoid duplicated issues**
 

README.md

@@ -42,9 +42,9 @@ similar to the way you would use ORM (Object-Relational Mapping) frameworks like
 [![static analysis](https://github.com/yiisoft/db/actions/workflows/static.yml/badge.svg?branch=dev)](https://github.com/yiisoft/db/actions/workflows/static.yml)
 [![type-coverage](https://shepherd.dev/github/yiisoft/db/coverage.svg)](https://shepherd.dev/github/yiisoft/db)
 
-## Usage 
+## Usage
 
-[Check the documentation](/docs/en/README.md) to learn about usage.
+[Check the documentation](/docs/guide/en/README.md) to learn about usage.
 
 ## Support
 
@@ -53,7 +53,7 @@ You may also check out other [Yii Community Resources](https://www.yiiframework.
 
 ## Testing
 
-[Check the testing instructions](/docs/en/testing.md) to learn about testing.
+[Check the testing instructions](/docs/guide/en/testing.md) to learn about testing.
 
 ## Support the project
 

docs/en/README.md → docs/guide/en/README.md

@@ -20,40 +20,40 @@ Yii DB supports the following databases out of the box:
 - [MySQL](https://www.mysql.com/) of versions **5.7 - 8.0**.
 - [MariaDB](https://mariadb.org/) of versions **10.4 - 10.9**.
 - [Oracle](https://www.oracle.com/database/) of versions **12c - 21c**.
-- [PostgreSQL](https://www.postgresql.org/) of versions **9.6 - 15**. 
-- [SQLite](https://www.sqlite.org/index.html) of version **3.3 and above**.
+- [PostgreSQL](https://www.postgresql.org/) of versions **9.6 - 15**.
+- [SQLite](https://www.sqlite.org/) of version **3.3 and above**.
 
 ## Installation
 
 To install Yii DB, you must select the driver you want to use and install it with [Composer](https://getcomposer.org/).
 
 For [MSSQL](https://github.com/yiisoft/db-mssql):
 
-```bash
+```shell
 composer require yiisoft/db-mssql
 ```
 
 For [MySQL/MariaDB](https://github.com/yiisoft/db-mysql):
 
-```bash
+```shell
 composer require yiisoft/db-mysql
 ```
 
 For [Oracle](https://github.com/yiisoft/db-oracle):
 
-```bash
+```shell
 composer require yiisoft/db-oracle
 ```
 
 For [PostgreSQL](https://github.com/yiisoft/db-pgsql):
 
-```bash
+```shell
 composer require yiisoft/db-pgsql
 ```
 
 For [SQLite](https://github.com/yiisoft/db-sqlite):
 
-```bash
+```shell
 composer require yiisoft/db-sqlite
 ```
 
@@ -108,10 +108,6 @@ Yii DB will automatically convert such constructs into the corresponding quoted
 For example, the following code will generate an SQL statement that's valid for all supported databases:
 
 ```php
-<?php
-
-declare(strict_types=1);
-
 use Yiisoft\Db\Connection\ConnectionInterface;
 
 /** @var ConnectionInterface $db */