On Tue, 2011-03-08 at 08:45 +0200, Raoul Snyman wrote: > On 8 March 2011 07:28, mjmein <[email protected]> wrote: > > Wouldn't it help if there was a big "where to start/first steps" > > section on the front page > > of the Pyramid website - similar to http://docs.djangoproject.com/en/1.2/. > > > > This could just link to the relevant cookbooks/tutorials. > > > > I think the problem currently is that people start by going into the > > main documentation, and then get overwhelmed. > > I agree, I also was rather overwhelmed when I went to the > documentation the first time. I can also echo the "abstract" > sentiment, I have found some of the documentation to be rather vague > in it's explanation. > > (Of course now when I try to find some of that vague, abstract > documentation that I remember seeing and struggling to understand in a > practical sense, I can't find it.)
I suspect the fact that you aren't noticing the abstract bits anymore is because it does get very concrete once you get a toehold on various concepts. But it's broad, so it may be rather difficult to get that first toehold. 600 pages of text is about as much as I'm willing to inflict on any human, so I think we're going to need to find a way of better providing various toeholds that doesn't involve writing yet more docs, but instead relies solely on reorganization. Oh-if-you-only-knew-how-I-learned-Python-ly y'rs, - C -- You received this message because you are subscribed to the Google Groups "pylons-discuss" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/pylons-discuss?hl=en.
