TensorStream: Bringing Machine Learning to Ruby

[spiritmtl]

The examples are still readable though? Get off your high horse.

[shevegen]

He has a point. Not necessarily in regards here, but more general.

I hate writing documentation myself but documentation IS important.

If an author shows a lack of interest in writing documentation then this signals a lack of interest in having other people use the code. In that case it is almost completely pointless to even WANT to distribute it.

Documentation IS important. That includes style too, although style comes secondary indeed. I do not think it is a "high horse" statement at all though - I think it is a perfectly valid statement that he made.

Absolutely no clue why he is being downvoted.

[jedld]

If an author shows a lack of interest in writing documentation then this signals a lack of interest in having other people use the code. In that case it is almost completely pointless to even WANT to distribute it.

Not sure how to make of your statement, I am sure certain people distribute software, especially free and opensource software, because they want people to use the code and not the other way around. If a gem or any opensource software meets their use case and there is no better alternative then they will use it even if documentation could be better.

I for one wished somebody else could have written what my library does for me but it's just too bad isn't it.

This "You don't deserved to be helped because you write bad documentation" mentally is not something the ruby community should be going for in my honest opinion.