Improve composer manifest

Author: nyamsprod

README.md

@@ -10,13 +10,8 @@ echo $url->toAsciiString();   // returns "https://xn--go8h.com/bar/baz?#fragment
 echo $url->toUnicodeString(); // returns "https://🐘.com/bar/baz?#fragment"
 ````
 
-This package provides a PHP polyfill for PHP version greater or equal to **PHP8.1** to the new
-native PHP URI parsing features that are in discussion to be included in **PHP8.5**.
-
-The RFC introduces:
-
-- an [RFC 3986](https://www.rfc-editor.org/rfc/rfc3986) compliant URI parser via the new `Uri\Rfc3986\Uri` class
-- an [WHATWG URL](https://url.spec.whatwg.org/) compliant parser via the new `Uri\WhatWg\Url` class
+This package provides a polyfill for PHP version greater or equal to **PHP8.1** to the new
+native PHP URI parsing features in [voting phase](https://wiki.php.net/rfc/url_parsing_api#vote) to be included in **PHP8.5**.
 
 ## System Requirements
 
@@ -26,16 +21,24 @@ To use the package you are required to use:
 - [League URI Interfaces](https://github.com/thephpleague/uri-interfaces) and its dependencies
 - [URL-Parser](https://github.com/TRowbotham/URL-Parser) and its dependencies
 
+> [!TIP]
+> You should install `symfony/polyfill-php82` to use its `SensitiveParameter` polyfill if you are using **PHP 8.1**
+
 ## Install
 
-Install `aidre-uri` using Composer.
+Install `aide-uri` using Composer.
 
 ```bash
 composer require bakame/aide-uri:dev-main
 ```
 
 ## Documentation
 
+The RFC introduces:
+
+- an [RFC 3986](https://www.rfc-editor.org/rfc/rfc3986) compliant URI parser via the new `Uri\Rfc3986\Uri` class
+- an [WHATWG URL](https://url.spec.whatwg.org/) compliant parser via the new `Uri\WhatWg\Url` class
+
 Full documentation can be found on the [Add RFC 3986 and WHATWG compliant URI parsing support RFC](https://wiki.php.net/rfc/url_parsing_api).
 
 ## Testing

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "bakame/aide-uri",
-    "description": "URI polyfill for PHP native RFC3986/WHATWG URI classes",
+    "description": "Polyfill backporting PHP 8.5+ native RFC3986/WHATWG URI features to lower PHP versions",
     "keywords": ["uri", "url", "rfc3986", "whatwg", "polyfill", "parser", "resolver", "equivalence", "compatibiliy", "portable"],
     "license": "MIT",
     "authors": [
@@ -35,6 +35,9 @@
         "phpbench/phpbench": "^1.4.1",
         "symfony/var-dumper": "^v6.4.21 || ^7.2.6"
     },
+    "suggest": {
+        "symfony/polyfill-php82": "To use the SensitiveParameter polyfill in PHP8.1"
+    },
     "scripts": {
         "benchmark": "phpbench run --report=default",
         "phpcs": "php-cs-fixer fix --dry-run --diff -vvv --allow-risky=yes --ansi",
@@ -49,11 +52,11 @@
         ]
     },
     "scripts-descriptions": {
-        "benchmark": "Runs parser benchmark",
+        "benchmark": "Runs URI and URL classes benchmark",
         "phpstan": "Runs complete codebase static analysis",
         "phpunit": "Runs unit and functional testing",
         "phpcs": "Runs coding style testing",
         "phpcs:fix": "Fix coding style issues",
-        "test": "Runs all tests"
+        "test": "Runs all tests (excluding the benchmark)"
     }
 }