Re: 2nd try at date/format.rb & pty.c

On 8/22/06, Hugh Sasse <[email protected]> wrote:
>
> One more point that I'd like to raise somewhere: at present there is
> no way to keep *internal* documentation with the code. Rdoc doesn't
> provide a means to support it apart from turning off Rdoc processing
> (which is fair enough, it wasn't a goal of the project), but if
> there were a means to markup documentation as being internal would
> this be a Bad Thing?



No, but it's hard enough persuading Ruby programmers that they need any
documentation at all. Most of them seem to have overdosed on Extreme
Programming Kool-Aid. I suspect it's a feature practically nobody would use.


mathew