I've been talking recently about what The League of Extraordinary Packages is up to, and made a plea to avoid "Not Invented Here" syndrome to help the community focus on quality instead of quantity. Today I came across a new pet-peeve.
Earlier this-morning, if you did a search for "pdf" on Packagist, you
will would have seen solid examples of two of my largest issues with the PHP Component eco-system, and even a brand new one.
- Framework specific code; There is a Yii-only PDF package and a Laravel-only PDF package.
- Attack of the Clones; there are so… so many…
- The New One - Missing descriptions; One the first page, the third and fourth packages were completely unlabeled.
In a world where there are (unfortunately) thousands of packages that do exactly the same thing, you'll need to at least add a description if you want to have anyone pick your package over anyone else's. This helps you get more users (and therefore more contributions) but also helps people skip your component if its no good for them.
I added a description to one, but another didn't even have a README for me to copy one from. The PR was merged and the README was added, meaning that those two now make a little more sense.
Please send a pull request to any package you see without a description. It goes in the
composer.json, and simply needs
"description" : "Copy some text from their README.", added in.
If you add a description to a package, please post the pull request up here for props.