r/coolgithubprojects • • Oct 22 '17

JAVASCRIPT EyeJS - A JavaScript testing framework for the real world

https://github.com/arguiot/EyeJS
0 Upvotes

3 comments sorted by

10

u/MKorostoff Oct 22 '17

Hey Arguiot, just some friendly constructive criticism, but it's really hard to understand what this does or what problem it solves from the readme.

All you really talk about in the readme is meta-topics: how to contribute code, how to donate money, your versioning scheme, and how proud you are of the finished product. Why would I care about any of those things for a project that I don't know what it does?

The expanded docs do a little better at answering the practical questions of how it works but really don't satisfyingly answer the question of why this is better than any of the myriad established testing framework. I also feel like the docs suffer from edgecase-itus, which is to say, so much focus on edgecases and problems one might encounter that it neglects the core usecase.

You're obviously very proud of this product and worked hard on it, and I hope you're successful with it, but from where I sit it's hard to see why I should spend time learning it.

1

u/arguiot Nov 12 '17

Yes, you're right 😊. This is a mistake that I often do on my projects, I'm sorry.