[plt-scheme] init-field order?
And, just in case you'd like to take a look at them, to see how far
we've gotten:
http://pre.plt-scheme.org/docs/html/
Robby
On Mon, Mar 3, 2008 at 10:34 AM, Matthew Flatt <mflatt at cs.utah.edu> wrote:
> At Mon, 03 Mar 2008 11:12:18 -0500, tom sgouros wrote:
> > The interpreter still seems fast and flexible, but the newer
> > documentation seems somewhat more telegraphic than the older parts, and
> > seems to be written for people who are already PhDs in computer science.
> > I found the class system documentation especially opaque, but the
> > documentation of what is and is not an mzchar or UCS-4 was also fairly
> > challenging to parse. In several cases during this push, after I
> > already understood the issue (from an answer on this list, or from
> > experimentation), I went back and easily found the single sentence that
> > would have explained the issue to me. But I'd rather have found it
> > first.
>
> Thanks for your feedback, and I agree with your characterization of the
> documentation. For reference documentation, I aim for succinctness, and
> I think I've probably gotten "better" in that dimension over the years;
> if so, the documentation will have become ever more dense.
>
> So, that's why we've embarked on the re-documentation effort as our
> highest priority --- including the creation of more readable "guides"
> to complement the "references" --- though we still have a long way to
> go.
>
> Matthew
>
>
>
> _________________________________________________
> For list-related administrative tasks:
> http://list.cs.brown.edu/mailman/listinfo/plt-scheme
>