From daceecf32152ce2a0ef53e2483d4d63196c2636b Mon Sep 17 00:00:00 2001
From: Luiz Marin <67489841+luizcmarin@users.noreply.github.com>
Date: Fri, 3 May 2024 12:51:23 -0300
Subject: [PATCH 1/4] Update file
---
README.md | 39 ++++++++++++++--------------
docs/{en/testing.md => internals.md} | 8 +++---
2 files changed, 23 insertions(+), 24 deletions(-)
rename docs/{en/testing.md => internals.md} (93%)
diff --git a/README.md b/README.md
index eab3a03..d9fe913 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,12 @@
+[![Latest Stable Version](https://poser.pugx.org/yiisoft/db-oracle/v/stable.png)](https://packagist.org/packages/yiisoft/db-oracle)
+[![Total Downloads](https://poser.pugx.org/yiisoft/db-oracle/downloads.png)](https://packagist.org/packages/yiisoft/db-oracle)
+[![rector](https://github.com/yiisoft/db-oracle/actions/workflows/rector.yml/badge.svg)](https://github.com/yiisoft/db-oracle/actions/workflows/rector.yml)
+[![codecov](https://codecov.io/gh/yiisoft/db-oracle/branch/master/graph/badge.svg?token=XGJAFXVHSH)](https://codecov.io/gh/yiisoft/db-oracle)
+[![StyleCI](https://github.styleci.io/repos/114756574/shield?branch=master)](https://github.styleci.io/repos/114756574?branch=master)
+
Oracle driver for [Yii Database](https://github.com/yiisoft/db) is a database driver for [Oracle] databases.
The package allows you to connect to [Oracle] databases from your application and perform various database operations
@@ -21,16 +27,10 @@ your Oracle database and perform various database operations as needed.
[Oracle]: https://www.oracle.com/database/technologies/
-[![Latest Stable Version](https://poser.pugx.org/yiisoft/db-oracle/v/stable.png)](https://packagist.org/packages/yiisoft/db-oracle)
-[![Total Downloads](https://poser.pugx.org/yiisoft/db-oracle/downloads.png)](https://packagist.org/packages/yiisoft/db-oracle)
-[![rector](https://github.com/yiisoft/db-oracle/actions/workflows/rector.yml/badge.svg)](https://github.com/yiisoft/db-oracle/actions/workflows/rector.yml)
-[![codecov](https://codecov.io/gh/yiisoft/db-oracle/branch/master/graph/badge.svg?token=XGJAFXVHSH)](https://codecov.io/gh/yiisoft/db-oracle)
-[![StyleCI](https://github.styleci.io/repos/114756574/shield?branch=master)](https://github.styleci.io/repos/114756574?branch=master)
-
## Support version
-| PHP | Oracle Version | CI-Actions
-|:----:|:------------------------:|:---:|
+| PHP | Oracle Version | CI-Actions
+|----|------------------------|---|
|**8.0 - 8.2**| **12c - 21c**|[![build](https://github.com/yiisoft/db-oracle/actions/workflows/build.yml/badge.svg?branch=dev)](https://github.com/yiisoft/db-oracle/actions/workflows/build.yml) [![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2Fyiisoft%2Fdb-oracle%2Fmaster)](https://dashboard.stryker-mutator.io/reports/github.com/yiisoft/db-oracle/master) [![static analysis](https://github.com/yiisoft/db-oracle/actions/workflows/static.yml/badge.svg?branch=dev)](https://github.com/yiisoft/db-oracle/actions/workflows/static.yml) [![type-coverage](https://shepherd.dev/github/yiisoft/db-oracle/coverage.svg)](https://shepherd.dev/github/yiisoft/db-oracle)
## Installation
@@ -41,15 +41,21 @@ The package could be installed via composer:
composer require yiisoft/db-oracle
```
-## Usage
+## Documentation
-For config connection to Oracle database check [Connecting Oracle](https://github.com/yiisoft/db/blob/master/docs/en/connection/oracle.md).
+- For config connection to Oracle database check [Connecting Oracle](https://github.com/yiisoft/db/blob/master/docs/en/connection/oracle.md).
+- [Check the documentation docs](https://github.com/yiisoft/db/blob/master/docs/en/README.md) to learn about usage.
+- [Internals](docs/internals.md)
-[Check the documentation docs](https://github.com/yiisoft/db/blob/master/docs/en/README.md) to learn about usage.
+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).
-## Testing
+## License
+
+The Yii Framework Oracle Extension is free software. It is released under the terms of the BSD License.
+Please see [`LICENSE`](./LICENSE.md) for more information.
-[Check the documentation](/docs/en/testing.md) to learn about testing.
+Maintained by [Yii Software](https://www.yiiframework.com/).
## Support the project
@@ -62,10 +68,3 @@ For config connection to Oracle database check [Connecting Oracle](https://githu
[![Telegram](https://img.shields.io/badge/telegram-join-1DA1F2?style=flat&logo=telegram)](https://t.me/yii3en)
[![Facebook](https://img.shields.io/badge/facebook-join-1DA1F2?style=flat&logo=facebook&logoColor=ffffff)](https://www.facebook.com/groups/yiitalk)
[![Slack](https://img.shields.io/badge/slack-join-1DA1F2?style=flat&logo=slack)](https://yiiframework.com/go/slack)
-
-## License
-
-The Yii Framework Oracle Extension 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/).
diff --git a/docs/en/testing.md b/docs/internals.md
similarity index 93%
rename from docs/en/testing.md
rename to docs/internals.md
index c715b19..c62f1bc 100644
--- a/docs/en/testing.md
+++ b/docs/internals.md
@@ -1,4 +1,4 @@
-# Testing
+# Internals
## Github actions
@@ -32,7 +32,7 @@ The following steps are required to run the tests:
vendor/bin/phpunit
```
-### Mutation testing
+## Mutation testing
The package tests are checked with [Infection](https://infection.github.io/) mutation framework with
[Infection Static Analysis Plugin](https://github.com/Roave/infection-static-analysis-plugin). To run it:
@@ -51,8 +51,8 @@ The code is statically analyzed with [Psalm](https://psalm.dev/). To run static
## Rector
-Use [Rector](https://github.com/rectorphp/rector) to make codebase follow some specific rules or
-use either newest or any specific version of PHP:
+Use [Rector](https://github.com/rectorphp/rector) to make codebase follow some specific rules or
+use either newest or any specific version of PHP:
```shell
./vendor/bin/rector
From eefd40b95049fba9151118f028f011e00ae0665c Mon Sep 17 00:00:00 2001
From: Luiz Marin <67489841+luizcmarin@users.noreply.github.com>
Date: Fri, 3 May 2024 13:04:38 -0300
Subject: [PATCH 2/4] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index d9fe913..1f8b39c 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
-
+
Oracle driver for Yii Database
From a59361f8f122580542355aaa133d81bed39d6bb2 Mon Sep 17 00:00:00 2001
From: Luiz Marin <67489841+luizcmarin@users.noreply.github.com>
Date: Sat, 4 May 2024 06:05:16 -0300
Subject: [PATCH 3/4] Update internals.md
---
docs/internals.md | 4 +---
1 file changed, 1 insertion(+), 3 deletions(-)
diff --git a/docs/internals.md b/docs/internals.md
index c62f1bc..015745d 100644
--- a/docs/internals.md
+++ b/docs/internals.md
@@ -20,9 +20,7 @@ docker compose up -d
## Unit testing
-The package is tested with [PHPUnit](https://phpunit.de/).
-
-The following steps are required to run the tests:
+The package is tested with [PHPUnit](https://phpunit.de/). To run tests:
1. Run the docker container for the dbms.
2. Install the dependencies of the project with composer.
From 94bc4a5df82b01fb1bb5a7da180711d8f0913b31 Mon Sep 17 00:00:00 2001
From: Luiz Marin <67489841+luizcmarin@users.noreply.github.com>
Date: Mon, 6 May 2024 07:03:46 -0300
Subject: [PATCH 4/4] Update README.md
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 1f8b39c..952d03b 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ your Oracle database and perform various database operations as needed.
## Installation
-The package could be installed via composer:
+The package could be installed with [Composer](https://getcomposer.org):
```php
composer require yiisoft/db-oracle