Turn off ri and rdoc generation by default

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.

[ Parent | on HN ]

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.

[ Parent | on HN ]

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.

[ Parent | on HN ]