News for hackers. Stuff that matters.
Re:Turn off ri and rdoc generation by default by wlll on Friday February 25, 2011 @09:24AM (#2262240)
From drbrain in the comments:

1.7 will replace --no-rdoc and --no-ri with a single --[no-]document option (which should be automatically aliased to --[no-]doc by optparse) making this easier to do.

Not quite the same, if that was what was meant, and calling people who express a valid opinion on this "propellerheads" just seems unnecessarily insulting. There are 200+ comments because people feel strongly about this and not because they are trolling.

Re:Turn off ri and rdoc generation by default by nirvdrum on Friday February 25, 2011 @11:28AM (#2262669)
I've found most of the comments on just about anything from the RubyGems guys to be off-putting, degrading, and/or insulting. Not to mention just about every new release breaks my apps on me and it's always made out to be my fault (or someone else's, but never the fault of RubyGems). It is probably my least favorite aspect of using Ruby and being part of the "community."
Re:Turn off ri and rdoc generation by default by rst on Friday February 25, 2011 @09:58AM (#2262338)
But he's directly refusing to make --no-doc the default, which is the whole point of the request.

People are complaining about having to install a .gemrc to get sensible behavior. Making the file a few characters shorter doesn't make it less of a burden.

Re:Turn off ri and rdoc generation by default by xiaomai on Friday February 25, 2011 @10:41AM (#2262479)
The sensible behavior is to install the documentation., so no .gemrc is necessary (to get sensible behavior).
Re:Turn off ri and rdoc generation by default by steveklabnik on Friday February 25, 2011 @10:45AM (#2262498)
That's the entire point of this discussion. A large body of Rubyists think that the sensible behavior is to _not_ install the documentation.

I google far more often than I ri.

Re:Turn off ri and rdoc generation by default by mcantor on Friday February 25, 2011 @03:04PM (#2263582)
Maybe the real problem is that Ruby documentation generally sucks! :-)
Re:Turn off ri and rdoc generation by default by steveklabnik on Friday February 25, 2011 @04:11PM (#2263788)
At least there are tests to make up for it. ;)
Re:Turn off ri and rdoc generation by default by bronson on Friday February 25, 2011 @11:35AM (#2262706)
The vast majority of gemrcs on github disagree with you:

http://www.google.com/search?hl=en&source=hp&biw=101...

Personally, I can switch to a browser window, google for a gem, find its docs, and read them online in less time than it takes for ri to return its usually incomplete result or ask for brain-dead disambiguation. Ruby would have a better reputation if ri simply didn't exist.

Re:Turn off ri and rdoc generation by default by generalk on Friday February 25, 2011 @11:15AM (#2262615)
That's the sensible behavior if you plan on reading local documentation.

I can't say I've ever used ri, although I do browse local rdoc, sometimes. I know plenty of developers that hadn't heard of "gem server" until I mentioned it. And this is completely discounting production environments, where the documentation is almost certainly a waste of deploy time.

Re:Turn off ri and rdoc generation by default by rue on Saturday February 26, 2011 @04:58PM (#2266628)
Approximately 60% of all questions on #ruby-lang could have been answered by ri, just for the core and stdlib. It's a shame it doesn't get used more.

It's an orthogonal problem, though. The main issue with doc generation is that it is really, really slow (compared to the rest of the install process). If it can be sped up – patches are surely welcome – it'll just leave the envs that flat-out don't need the docs, ever, and those can use the new --no-doc.

Re:Turn off ri and rdoc generation by default by geeksam on Friday February 25, 2011 @07:25PM (#2264385)
I hadn't heard of "gem server" until you mentioned it.
Re:Turn off ri and rdoc generation by default by bschaefer on Friday February 25, 2011 @09:59AM (#2262343)
...calling people who express a valid opinion on this "propellerheads" just seems unnecessarily insulting

When did "+1" become a valid opinion?

The few people who attempted to actually discuss the patch were more than drowned out by -- well -- a bunch of propellerheads.

Re:Turn off ri and rdoc generation by default by wlll on Friday February 25, 2011 @10:06AM (#2262376)
It's shorthand for agreeing with the original idea. It saves space and allows a much quicker scanning of the comments to find people who have something unique to say.

If everyone wrote a short paragraph on their agreement with the original idea it would be very hard to find the comments where people were either dissenting or had something original to say.

Re:Turn off ri and rdoc generation by default by Dylan16807 on Friday February 25, 2011 @10:24AM (#2262433)
Is this a flaw in github? It has this nice compact list of people at the top; there's no way to join it without spamming a comment?
Re:Turn off ri and rdoc generation by default by xiaomai on Friday February 25, 2011 @10:43AM (#2262485)
I like launchpad's "This bug also affects me" link. Maybe github could implement something similar.
Re:Turn off ri and rdoc generation by default by steveklabnik on Friday February 25, 2011 @10:46AM (#2262501)
I'd say it's a sensible default that happens to be broken in this case. ;)
Re:Turn off ri and rdoc generation by default by matthewcford on Friday February 25, 2011 @12:06PM (#2262841)
they just need up-votes - effectively a plus 1
Re:Turn off ri and rdoc generation by default by steveklabnik on Friday February 25, 2011 @09:26AM (#2262246)
I also think that it's a bit excessive. Some people seem to get frothy at the mouth when they see 'dhh.'