[plt-scheme] init-field order?

From: Robby Findler (robby at cs.uchicago.edu)
Date: Mon Mar 3 11:37:04 EST 2008

And, just in case you'd like to take a look at them, to see how far
we've gotten:



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

Posted on the users mailing list.