Docs folder standardization and other fixes (#296)

README.md

@@ -36,11 +36,11 @@ perform advanced database operations such as joins and aggregates.
 
 The package could be installed via composer:
 
-```php
+```shell
 composer require yiisoft/db-sqlite
 ```
 
-## Usage 
+## Usage
 
 For config connection to SQLite database check [Connecting SQLite](https://github.com/yiisoft/db/blob/master/docs/en/connection/sqlite.md).
 

docs/en/testing.md → docs/internals.md

@@ -1,4 +1,4 @@
-# Testing
+# Internals
 
 ## Github actions
 
@@ -8,13 +8,13 @@ All our packages have github actions by default, so you can test your [contribut
 
 ## Unit testing
 
-The package is tested with [PHPUnit](https://phpunit.de/).
+The package is tested with [PHPUnit](https://phpunit.de/). To run tests:
 
 ```shell
-vendor/bin/phpunit
+./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:
@@ -33,16 +33,17 @@ 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
 ```
 
-## Composer require checker
+## Dependencies
 
-This package uses [composer-require-checker](https://github.com/maglnet/ComposerRequireChecker) to check if all dependencies are correctly defined in `composer.json`.
+Use [ComposerRequireChecker](https://github.com/maglnet/ComposerRequireChecker) to detect transitive
+[Composer](https://getcomposer.org/) dependencies.
 
 To run the checker, execute the following command:
 

phpunit.xml.dist

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" backupGlobals="false" colors="true" bootstrap="vendor/autoload.php" failOnRisky="true" failOnWarning="true" executionOrder="default" resolveDependencies="true" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.1/phpunit.xsd">
+<phpunit xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" backupGlobals="false" colors="true" bootstrap="vendor/autoload.php" failOnRisky="true" failOnWarning="true" executionOrder="default" resolveDependencies="true" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.1/phpunit.xsd">
   <coverage/>
   <php>
     <ini name="error_reporting" value="-1"/>

psalm.xml

@@ -3,7 +3,7 @@
     errorLevel="1"
     findUnusedBaselineEntry="true"
     findUnusedCode="false"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
     xmlns="https://getpsalm.org/schema/config"
     xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
 >

psalm4.xml

@@ -3,7 +3,7 @@
     errorLevel="1"
     findUnusedBaselineEntry="true"
     findUnusedCode="false"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
     xmlns="https://getpsalm.org/schema/config"
     xsi:schemaLocation="https://getpsalm.org/schema/config vendor/vimeo/psalm/config.xsd"
 >

src/DQLQueryBuilder.php

@@ -94,7 +94,7 @@ public function buildLimit(ExpressionInterface|int|null $limit, ExpressionInterf
             /**
              * Limit isn't optional in SQLite.
              *
-             * {@see http://www.sqlite.org/syntaxdiagrams.html#select-stmt}
+             * {@see https://www.sqlite.org/syntaxdiagrams.html#select-stmt}
              */
             $sql = 'LIMIT 9223372036854775807 OFFSET ' . // 2^63-1
                 ($offset instanceof ExpressionInterface ? $this->buildExpression($offset) : (string)$offset);

src/Dsn.php

@@ -24,7 +24,7 @@ public function __construct(private string $driver, private string|null $databas
     /**
      * @return string The Data Source Name, or DSN, has the information required to connect to the database.
      *
-     * Please refer to the [PHP manual](http://php.net/manual/en/pdo.construct.php) on the format of the DSN string.
+     * Please refer to the [PHP manual](https://php.net/manual/en/pdo.construct.php) on the format of the DSN string.
      *
      * The `driver` array key is used as the driver prefix of the DSN, all further key-value pairs are rendered as
      * `key=value` and concatenated by `;`. For example:

src/SqlTokenizer.php

@@ -12,7 +12,7 @@
  *
  * It's used to obtain `CHECK` constraint information from a `CREATE TABLE` SQL code.
  *
- * @link http://www.sqlite.org/draft/tokenreq.html
+ * @link https://www.sqlite.org/draft/tokenreq.html
  * @link https://sqlite.org/lang.html
  */
 final class SqlTokenizer extends AbstractTokenizer

src/Transaction.php

@@ -29,7 +29,7 @@ final class Transaction extends AbstractPdoTransaction
      * @throws Throwable When unsupported isolation levels are used. SQLite only supports `SERIALIZABLE`
      * and `READ UNCOMMITTED`.
      *
-     * @link http://www.sqlite.org/pragma.html#pragma_read_uncommitted
+     * @link https://www.sqlite.org/pragma.html#pragma_read_uncommitted
      */
     protected function setTransactionIsolationLevel(string $level): void
     {