4 ms·

I was about to say the same. Never understood the "read the source" attitude. If the developer wants to gain users or maybe even get help in developing it, at

I was about to say the same. Never understood the "read the source" attitude. If the developer wants to gain users or maybe even get help in developing it, at least a simple installation and usage example should be there. 15 minutes work for him, would save every user 30 or more minutes. Not going to try it because of this. A shame. Did find another interesting cli though: https://pypi.org/project/sonos-cli/ https://pypi.org/project/sonos-cli/

tekstar 7y ago
The project is 12 days old. Maybe you could contribute instead of complaining?
- BozeWolf 7y ago
  I wish! All I can contribute is expressing my concerns. Don't want to be impolite, don't want to complain. Just express my concerns. I find it quite frustrating that open source/current company projects have no or little documentation. Even for a 12 days project it is frustrating. It is just good habit that documentation is as important as code. I like to say that if it has no documentation, it does not exist (to the user/contributor). I also think that code is a way of communicating with your future self or future developers. So clear code and clear documentation is important. Code is not important to the computer, the computer does not care about naming things.
  - shakna 7y ago
    From another perspective: Whilst I am likely to spend far more time documenting than coding in my work, when I build something at home to fix a problem just for me I'm far less likely because it's for me. In the case of this particular developer, it isn't just for themselves, but also in a different language, and they've done their best just to reflect an existing API. They've asked for pull requests. I can understand not wanting to do the enormous amount of work of translating an API that is already pretty-much documented when I won't really see any return at all.

tekstar 7y ago

The project is 12 days old. Maybe you could contribute instead of complaining?

BozeWolf 7y ago
I wish! All I can contribute is expressing my concerns. Don't want to be impolite, don't want to complain. Just express my concerns. I find it quite frustrating that open source/current company projects have no or little documentation. Even for a 12 days project it is frustrating. It is just good habit that documentation is as important as code. I like to say that if it has no documentation, it does not exist (to the user/contributor). I also think that code is a way of communicating with your future self or future developers. So clear code and clear documentation is important. Code is not important to the computer, the computer does not care about naming things.
- shakna 7y ago
  From another perspective: Whilst I am likely to spend far more time documenting than coding in my work, when I build something at home to fix a problem just for me I'm far less likely because it's for me. In the case of this particular developer, it isn't just for themselves, but also in a different language, and they've done their best just to reflect an existing API. They've asked for pull requests. I can understand not wanting to do the enormous amount of work of translating an API that is already pretty-much documented when I won't really see any return at all.