Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Neil Van Dyke
Racket Noob wrote at 12/19/2011 05:02 PM: I think that Racket primarily serves to a specific group of people as an inexhaustible source for mass-production of always the same academic articles, and much less for everyday, practical programming. I myself am quite fond of inflammatory tone as re

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Todd O'Bryan
I think Racket Noob is actually somebody from another language just messing with people. The hotmail address, the erudite vocabulary couched in slightly broken English, the clearly antagonistic tone...it all adds up to a plant. The question is who? Is it Guido? Matz? Martin Odersky? I somehow thin

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread John Clements
On Dec 19, 2011, at 5:02 PM, Racket Noob wrote: > Jordan, beautiful are your ideas and suggestions, but unfortunately, I think > that they are futile. Why do I say this? I think that Racket primarily serves > to a specific group of people as an inexhaustible source for mass-production > of alw

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Matthias Felleisen
On Dec 19, 2011, at 5:02 PM, Racket Noob wrote: > Jordan, beautiful are your ideas and suggestions, but unfortunately, I think > that they are futile. Why do I say this? I think that Racket primarily serves > to a specific group of people as an inexhaustible source for mass-production > of alw

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Neil Van Dyke
Jordan Schatz wrote at 12/19/2011 01:04 PM: Also it would be really nice to be told how one "should" develop with racket... there is abunch of extra information that could be hidden in an introduction to racket for experienced develops type of manual, and alot of direction that could be given. Pr

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Racket Noob
Jordan, beautiful are your ideas and suggestions, but unfortunately, I think that they are futile. Why do I say this? I think that Racket primarily serves to a specific group of people as an inexhaustible source for mass-production of always the same academic articles, and much less for everyda

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Grant Rettke
On Mon, Dec 19, 2011 at 12:04 PM, Jordan Schatz wrote: > Also it would be really nice to be told how one "should" develop with > racket... there is abunch of extra information that could be hidden in an > introduction to racket for experienced develops type of manual, and alot > of direction that

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Jordan Schatz
On Sun, Dec 18, 2011 at 05:19:11PM -0500, Danny Yoo wrote: > I think you're really complaining about the following: you're not > finding easy "next steps" to continue after the Continue tutorial. Is > that your understanding as well? > > That would mean, not that the reference documentation is no

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Jordan Schatz
> web world!). Let's face it: Jay McCarthy is perhaps an excellent > programmer and all his honor. But, as a documentation writer, this man > has no idea. This is my well-intentioned advice to this community: let > someone with more literary talent to write documentation for web > development in t

Re: [racket] Racket documentation for web development is just awful!

2011-12-19 Thread Jordan Schatz
> write it with the help of list members here. I've got the barest of a start here: http://github.com/shofetim/Racket-the-Missing-Manual On Sat, Dec 17, 2011 at 11:18:03AM -0500, Matthias Felleisen wrote: > > Dear Racket Noon, thank you for outspoken criticism. There is no > question that all o

Re: [racket] Racket documentation for web development is just awful!

2011-12-18 Thread Danny Yoo
2011/12/17 Racket Noob : > >  I've already read. Continue tutorial is not bad, I passed through it > (congratulations, Danny Yoo, you're man!) Wait, wait. You can't thank me on this one and ignore Jay on this: he's a co-author. He absolutely shares the blame for that document too! :) A few pe

Re: [racket] Racket documentation for web development is just awful!

2011-12-18 Thread Jay McCarthy
That's already possible with "stateless" servlets, through the stuffer API, I'll investigate doing it for stateful ones and get back to you. Jay On Sat, Dec 17, 2011 at 1:16 PM, Sam Tobin-Hochstadt wrote: > Would it be possible for programmer to provide a name generator, so > that you could have

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Gerry Weaver
you along the way. I don't think it is necessary or productive to call someone out. We should just be thankful that we have Racket and any docs for it at all. Just my .02 Thanks, Gerry -Original Message- From: "Racket Noob" To: users@racket-lang.org Date: 12/17/11 10:06 Sub

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Sam Tobin-Hochstadt
Would it be possible for programmer to provide a name generator, so that you could have pretty urls of the form: foo.com/session/175 You'd have to ensure in the web server that there weren't conflicts with the names currently being managed, but it seems plausible. On Sat, Dec 17, 2011 at 3:12 PM

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Jay McCarthy
But, if you would like to have more traditional URLs in addition to the continuation/cryptic ones, you can use the web-server/dispatch library: http://docs.racket-lang.org/web-server/dispatch.html It starts with a bit of guide to orient you before the reference manual. It allows you to create UR

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Shriram Krishnamurthi
Hi R. Noob, > Do the URLs of pages that use continuation > mechanism have to look ugly and cryptic? Yes they do. The URLs are ugly *because* they are cryptic. They are cryptic because it is a route to system security. If they were pretty, people could guess them, and that would adversely affec

[racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
think this is one of the main reasons for poor use of Racket in the web (otherwise, Racket is just great!). Date: Sat, 17 Dec 2011 12:06:54 -0500 From: n...@neilvandyke.org To: racketn...@hotmail.com Subject: Re: [racket] Racket documentation for web development is just awful! Racket

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Hendrik Boom
on mechanism > have to look ugly and cryptic? Can this somehow be avoided (so that we have > pretty URLs, but still have a continuation?) Racket Noob > From: > sa...@ccs.neu.edu > > Date: Sat, 17 Dec 2011 11:18:06 -0500 > > Subject: Re: [racket] Racket documentation f

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Neil Van Dyke
Racket Noob wrote at 12/17/2011 11:05 AM: and, if we look at the number of web applications written in Racket today, they can be counted on the fingers of one hand. There's at least a few more than that. Some Racket developers are secretive. Regarding the topic of your message, consider tha

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
etty URLs, but still have a continuation?) Racket Noob > From: sa...@ccs.neu.edu > Date: Sat, 17 Dec 2011 11:18:06 -0500 > Subject: Re: [racket] Racket documentation for web development is just awful! > To: racketn...@hotmail.com > CC: users@racket-lang.org > > First, I want to

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Sam Tobin-Hochstadt
First, I want to encourage you to take a look at the "Continue" tutorial: http://docs.racket-lang.org/continue/ . It provides an excellent introduction for people new to the Racket web server. Second, one of the great things about Jay is that in addition to the video game talent and popped collars

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Matthias Felleisen
Dear Racket Noon, thank you for outspoken criticism. There is no question that all of our documentation and writing could be improved so that a lot more people can understand the basics. So here is a proposal: write it with the help of list members here. Yes, there's a significant gap betw

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Robby Findler
Please, if you have constructive criticism, it would be welcome. But messages like this are not helpful. Robby 2011/12/17 Racket Noob : > > Dear Racketeers, > > I think I am a man of average intelligence. I have read, for example, HtDP > and SICP without any major problems. Nevertheless, even wit

[racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
Dear Racketeers, I think I am a man of average intelligence. I have read, for example, HtDP and SICP without any major problems. Nevertheless, even with the best will, I do not understand the documentation called "Web Applications in Racket", written by Jay McCarthy (http://docs.racket-lang