docs: update notes about phpDocumentor3 compatibility

Author: nelson6e65

README.md

@@ -42,13 +42,15 @@ Explore sources of [nelson6e65/phpdoc-vuepress](https://github.com/nelson6e65/ph
 
 - PHP >= 5.6
 - Node.js >= 8
-- [phpDocumentor](https://www.phpdoc.org/).
+- [phpDocumentor](https://www.phpdoc.org/) 2.
 - [Yarn](https://yarnpkg.com) (or npm)
 - [VuePress](https://vuepress.vuejs.org/).
 
 > This template is designed for [phpDocumentor 2](https://www.phpdoc.org/) and [VuePress 1](https://v0.vuepress.vuejs.org/).
 > Read more about dependencies in the [Documentation](https://nelson6e65.github.io/phpdoc-vuepress/guide/getting-started.html).
 
+> Note: phpDocumentor 2 is able to generate documentation of code written on maybe any version of PHP < 8, but should be run on PHP 7.2. You can configure a CI like Travis CI, Netlify of Github Actions to generate the documentation on PHP 7.2 for your code if not using it on your local environment. Compatibility with phpDocumentor 3 is in progress 🚧 to support new features it offers.
+
 ## Installation
 
 Install `nelson6e65/phpdoc-vuepress` with composer:
@@ -57,7 +59,7 @@ Install `nelson6e65/phpdoc-vuepress` with composer:
 composer require --dev nelson6e65/phpdoc-vuepress
 ```
 
-> You may need to set the composer option [minimum-stability](https://getcomposer.org/doc/04-schema.md#minimum-stability) to 'dev' in order to be able to install pre-releases.
+> **Note for pre-releases:** You may need to set the composer option [minimum-stability](https://getcomposer.org/doc/04-schema.md#minimum-stability) to 'dev' or 'beta' in order to be able to install pre-releases.
 
 ## Usage
 

docs/guide/configuration.md

@@ -2,7 +2,7 @@
 
 ## Configuring phpDocumentor
 
-> These instructions are for phpDocumentor 2, but similar approachment will be valid for phpDocumentor 3.
+> These instructions are for phpDocumentor 2. phpDocumentor 3 is not _yet_ compatible.
 
 You need to tell phpDocumentor (1) where are your PHP source files, (2) where to generate the API documentation and (3) where is the template (for a Composer project, is ). You can, also, (4) configure which elements include by its visibility.
 
@@ -108,4 +108,4 @@ And then just run `composer phpdoc` :sunglasses:.
 
 :::
 
-> For further information, check the [Runing phpDocumentor documentation](https://docs.phpdoc.org/guides/running-phpdocumentor.html).
+> For further information, check the [Runing phpDocumentor documentation](https://docs.phpdoc.org/2.9/guides/running-phpdocumentor.html).

docs/guide/getting-started.md

@@ -8,21 +8,29 @@
 
 ### Dependencies
 
-- **phpDocumentor**: This template is designed for [phpDocumentor 2.x (2.9.1)](https://github.com/phpDocumentor/phpDocumentor#phpdocumentor), but may be compatible with upcoming **phpDocumentor3**.
+- **phpDocumentor 2**: This template is designed for [phpDocumentor 2.x (2.9.1)](https://github.com/phpDocumentor/phpDocumentor/tree/2.9#readme).
 - **VuePress**: You can use the [version 1.x](https://v1.vuepress.vuejs.org/) by default, but you can also use [version 0.x](https://v0.vuepress.vuejs.org/), depending on your configuration compatibility.
 
 You can globally install them:
 
 ```bash
 # phpDocumentor2 globally
-composer global require phpdocumentor/phpdocumentor:^2.9.0
+composer global require phpdocumentor/phpdocumentor:^2.9.1
 
 # VuePress
 npm i -D vuepress
 ```
 
 > Read about [VuePress install](https://vuepress.vuejs.org/guide/getting-started.html).
 
+::: warning phpDocumentor3 compatibility
+At the moment, this template _is not compatible_ with the stable release of **phpDocumentor 3**, which supports new features of the latest PHP versions.
+
+It should generate documentation of any code written on PHP < 8, but, as **phpDocumentor 2**, the documentation should be generated on PHP 7.2 or 7.3. You can configure a CI like Travis CI, Netlify of Github Actions to generate the API documentation on PHP 7.2 for your code if not using it on your local environment.
+
+Compatibility with **phpDocumentor 3** is in progress 🚧 to support new features it offers.
+:::
+
 ## Installation
 
 Install `nelson6e65/phpdoc-vuepress` with composer:
@@ -31,7 +39,7 @@ Install `nelson6e65/phpdoc-vuepress` with composer:
 composer require --dev nelson6e65/phpdoc-vuepress
 ```
 
-> You may need to set the composer option [minimum-stability](https://getcomposer.org/doc/04-schema.md#minimum-stability) to 'dev' in order to be able to install pre-releases.
+> Pre-releases: You may need to set the composer option [minimum-stability](https://getcomposer.org/doc/04-schema.md#minimum-stability) to 'dev' in order to be able to install pre-releases.
 
 ## Usage