[plt-dev] language dialog

From: Eli Barzilay (eli at barzilay.org)
Date: Fri Jan 29 10:44:36 EST 2010

On Jan 29, Robby Findler wrote:
> On Thu, Jan 28, 2010 at 4:52 PM, Ryan Culpepper <ryanc at ccs.neu.edu> wrote:
> > Robby Findler wrote:
> >>
> >> Matthew suggested a change to the language dialog that I've just now
> >> checked in. Please give it a try and let me know what you think.
> >
> > I think the explanatory text under the first option should be replaced with
> > something like the following:
> >
> >  Typical language declarations:
> >    #lang <language-name>
> >    #!r6rs
> >
> > Or perhaps instead of the abstract #lang example have two concrete ones,
> > like "#lang scheme" and "#lang typed/scheme".
> >
> > It should also have a link to an explanation of language declarations in the
> > help desk, either following the examples or as the text "language
> > declarations" above hyperlinked.
> 
> Does it make sense to have a link to an introduction that explains
> #lang (and moves on to other things) instead?

I thought that something like
  http://docs.plt-scheme.org/guide/Module_Syntax.html
would be right, except that this section needs some improvements, like
avoiding the `module' reference (or maybe explaining it much later
than the first sentence), and generally making it more beginner
friendly.

-- 
          ((lambda (x) (x x)) (lambda (x) (x x)))          Eli Barzilay:
                    http://barzilay.org/                   Maze is Life!


Posted on the dev mailing list.