From: Conrad Schneiker <schneik@...>
Date: 2000-05-22T23:37:36-05:00
Subject: [ruby-talk:02943] Re: What to document?

Hi,

Dave Thomas wrote:

> OK folks, the book is getting down to the wire, and we're running into
> a page-count crunch. Basically, we've already blown past our initial
> page estimate by a hundred pages, and we're desperately trying to stop
> it becoming 200 pages over.
>
> We're getting close, though. One of the few things left is deciding
> what things in /ext to document. The problem is, they're all
> HUGE. Doing tcltk or socket justice would take at least 50 pages,
> probably more.
>
> So, my questions:
>
> 1. Do we need to document them?
> 2. If so, which ones?

If it comes down to triage, I recommend taking a poll of actual usage on
the larger Japanese newsgroups to estimate relative *usage*. Hopefully the
(say) 5% response rate will still be statistically representative of the
approximate order of importance. An indirect way of doing the same thing
is to "grep" the various mail list archives for usage questions on these
topics. (This is tricky because you want to count number of threads hit,
not the number of notes hit.)

Conrad Schneiker
(This note is unofficial and subject to improvement without notice.)