[plt-scheme] Tables in Scribblings

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Thu Sep 11 20:32:23 EDT 2008

At Thu, 11 Sep 2008 18:27:49 -0500, "Grant Rettke" wrote:
> > Can you specify which parts made no sense, and how they can be improved?
> 
> I was sort of expecting the documentation to have everything you would
> need to know to do %80 of your tasks in one or two pages. Instead
> there is a lot of material, but it isn't obvious (to me) where to look
> or where to start. I was excited to see Scribble when it came out; but
> quickly found that I just "didn't get it". I assumed it was too
> powerful for what I wanted to do with it, which basically amounts to
> what one wants to do with HTML. The best place I have to figure things
> out is to look at the source code for the documentation.
> 
> Sometimes obvious operations seem confusing, so people post about them
> and knowledgeable folks answer so quickly that I feel like it must be
> confusing to you guys why people don't get it! :)

I think Eli was asking more specifically about documentation for the
"@" reader syntax, but your point is well taken. It will take us a
while to refine Scribble into something that meets our documentation
needs, is easy to use, and has good documentation for itself.


Matthew



Posted on the users mailing list.