For example, a user finds interest in imagick so goes here:

http://pear.php.net/imagick
http://pear.php.net/package-info.php?pacid=76
http://pear.php.net/package-info.php?package=imagick

Great but where's the documentation?  If documentation exists for a package (in the pear manual), package-info.php  should automagically link to it. In this case the link would be:

http://pear.php.net/manual/en/pecl.imagick.php

Ideally this would go both ways (the docs automagically link  to the package info).

Of course this should be done during the build process and not be done manually by the package or documentation maintainers.