[arc-discuss] Re: ARC case info broken on OS.o?

[James Carlson]

Bart Smaalders writes:
> I suggest that telling project teams to generate custom
> "lightweight" docs for open source docs is an waste
> of time and money.

I'd mostly agree with that.

>  There were over 5000 functions in the
> php documentation; do you think the ARC members will read 500
> pages of function specifications?

No.  But one of the responsibilities of a fast-track sponsor is to
make sure that the materials submitted are appropriate for the case --
and that they're in a form that can be reviewed in a reasonable
manner.

In some instances, this means explaining just what namespaces are
claimed ("all functions start with libfoo_*").  In others, it involves
producing summaries.

Simply dumping a large pile of files into a directory doesn't
necessarily solve the "what are we reviewing?" problem in a coherent
way.

-- 
James Carlson, Solaris Networking              <james.d.carlson at sun.com>
Sun Microsystems / 1 Network Drive         71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677