News for hackers. Stuff that matters.
Re:Sonos smart speaker controller API and CLI written in Rust by BozeWolf on Tuesday October 01, 2019 @09:25AM (#21125041)
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/

Re:Sonos smart speaker controller API and CLI written in Rust by tekstar on Tuesday October 01, 2019 @09:49AM (#21125265)
The project is 12 days old.

Maybe you could contribute instead of complaining?

Re:Sonos smart speaker controller API and CLI written in Rust by BozeWolf on Tuesday October 01, 2019 @10:14AM (#21125520)
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.

Re:Sonos smart speaker controller API and CLI written in Rust by shakna on Tuesday October 01, 2019 @11:03AM (#21126072)
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.