[plt-dev] language dialog
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!