pecl has a dedicated section on php.net: https://www.php.net/manual/en/install.pecl.php, it should mention pie as a replacement.

In order to promote pie as the official replacement, the documentation should be there also. The existing documentation could be ported as a first step.