8

(Ok, I love js in general (specially with es6), but here's something I hate about the "ecosystem". Dont take this too srsly also)

Holy fucking gagged shit, these project readmes that start out for too long about the project objective instead of stating the actual thing/s the software does.

WHAT DOES IT FUCKING DO!?
STOP BEING FUCKING FANCY ABOUT YOUR PROJECT.

Jesus christ, people jacking off about their awesome tool and how it will make everyone happy. No one cares.

"shitsmoke.js is a framework that focuses on delivering truly reliable data with static checking enabled on deployment."

WHAT THE SHIT DOES THAT MEAN?

Gimme a bullet point with the goddamn features (not the fucking BENEFITS) and I'm done.

These are like layers of marketing bullshit texts you have get through, getting more technical as you go on.

But sometimes they never do a technical summary, THEY GO STRAIGHT INTO THE GODDAMN API. And the API docs belong to a docs site, there is github.io and packages that take care of that.

You're like a goddamn linguistic detective, trying to disect the meaning of these words to understand if some package is what you're looking for.

And I don't wanna visit another website to understand what it does either!

Comments
  • 2
    @gintko that's a surefire way to kill one's productivity once and for all if you really start improving all the shitty projects you run across while looking for something.

    You'll be finished earlier if you don't use any open source at this point and instead write it from scratch.
Add Comment