read

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.

Right now, if you

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.

  1. Framework specific code; There is a Yii-only PDF package and a Laravel-only PDF package.
  2. Attack of the Clones; there are so… so many…
  3. 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.


If you appreciate these articles and want me to keep them coming, fire some coins over. Maybe I'll even run the next one through a spell checker.

bitcoin - 1PNbuCjgATjaaHtq7zZKqe3FBL7ngyDi23
etherium - 0x507d6E943885a5AeD76Fa3C43dB5C73a0f1Dc792

Blog Logo

Phil Sturgeon

Platform Engineer @ WeWork who talks about APIs a lot. Programming Polyglot, Pragmatist, Centerist and Sarcasist. Ex-The League of Extraordinary Packages, PHP The Right Way, Ex-PHP-FIG, Ex-CodeIgniter, Ex-FuelPHP, Ex-PyroCMS.

Book Cover

Build APIs You Won't Hate

Everyone and their dog wants an API, so you should probably learn how to build them.

Buy it from LeanPub or Amazon.

Image

Phil Sturgeon

Platform Engineer @ WeWork who talks about APIs a lot. Programming Polyglot, Pragmatist, Centerist and Sarcasist. Ex-The League of Extraordinary Packages, PHP The Right Way, Ex-PHP-FIG, Ex-CodeIgniter, Ex-FuelPHP, Ex-PyroCMS.

Back to Overview