From: Run Paint Run Run <runrun@...>
Date: 2009-06-19T09:42:42+09:00
Subject: [ruby-core:23922] Re: [Bug #1640] [PATCH] Documentation for the 	Rational Class

> ok, i understand.
> i didn't notice it due to focus the text.
> i think i should have reviewed rdocs numeric and others.
> and i think we don't need copy & paste text.

As you noted, the few descriptions that were derived from other rdoc
have either been since removed or heavily edited. Given the way rdoc
works, some text duplication is necessary to ensure that all methods
have descriptions. It's singularly unhelpful, for example, to remove
the documentation for Rational#divmod on the basis that Numeric#divmod
is similar. This requires the potential user of Rational#divmod to
execute `ri Rational#divmod`, be informed that "Nothing [is] known
about Rational#divmod", execute `ri Rational`and find nothing there,
then, hopefully, guess that Rational inherits from Numeric, despite
the rdoc not mentioning this, then execute `ri Numeric#divmod`, and
translate between the examples.

What are you suggesting?

-- 
Run Paint Run Run