translation into Brazilian Portuguese and corrections in the English … (

#819)

.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**
 

LICENSE.md

@@ -1,17 +1,17 @@
-Copyright © 2008 by Yii Software (https://www.yiiframework.com/)
+Copyright © 2008 by Yii Software (<https://www.yiiframework.com/>)
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 
- * Redistributions of source code must retain the above copyright
+* Redistributions of source code must retain the above copyright
    notice, this list of conditions and the following disclaimer.
- * Redistributions in binary form must reproduce the above copyright
+* Redistributions in binary form must reproduce the above copyright
    notice, this list of conditions and the following disclaimer in
    the documentation and/or other materials provided with the
    distribution.
- * Neither the name of Yii Software nor the names of its
+* Neither the name of Yii Software nor the names of its
    contributors may be used to endorse or promote products derived
    from this software without specific prior written permission.
 

README.md

@@ -42,18 +42,26 @@ 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 
+## Requirements
 
-[Check the documentation](/docs/en/README.md) to learn about usage.
+- PHP 8.0 or higher.
 
-## Support
+## Documentation
 
-If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/db/68) is a good place for that.
-You may also check out other [Yii Community Resources](https://www.yiiframework.com/community).
+- [English](docs/guide/en/README.md)
+- [Português - Brasil](docs/guide/pt-BR/readme.md)
+
+Testing:
+
+- [English](docs/guide/en/testing.md)
+- [Português - Brasil](docs/guide/pt-BR/testing.md)
 
-## Testing
+- [Internals](docs/internals.md)
 
-[Check the testing instructions](/docs/en/testing.md) to learn about testing.
+## Support
+
+If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/63) is a good place for that.
+You may also check out other [Yii Community Resources](https://www.yiiframework.com/community).
 
 ## Support the project
 
@@ -69,7 +77,7 @@ You may also check out other [Yii Community Resources](https://www.yiiframework.
 
 ## License
 
-The Yii DataBase Library is free software. It's released under the terms of the BSD License.
+The Yii Access is free software. It is released under the terms of the BSD License.
 Please see [`LICENSE`](./LICENSE.md) for more information.
 
 Maintained by [Yii Software](https://www.yiiframework.com/).

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

@@ -20,40 +20,44 @@ 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**.
+
+## Requirements
+
+- PHP 8.0 or higher.
 
 ## 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 +112,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 */