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
