Hi, I'm not sure is it a good place for this topic. I hope it is. I know PyCon US was long time ago - but I have just watched Carlos de la Guardia's "The Pyramid FAQ" and I would like to share You my ideas concerning newbies documentation.
There is four/five extremely newbie friendly websites teaching "something" in the way I just loved: 1. http://gitref.org/ 2. http://gitimmersion.com/ 3. http://tryhaskell.org/ 4. http://railsforzombies.org/ First, which is the source control reference, is approached to systematize Your knowledge and way of thinking about this particular source control system which is different then other. The goal is to show and learn basic concepts which allow You to understand many decisions was made in this approach. It is also helps person to "change thinking" when they coming from another source control system to think properly in the terms of new technology. IMHO Pyramid will need few such tutorials: each for different approach. But it helps people using different frameworks to switch to Pyramid. I think. Second - gitimmersion - is tutorial for the same version control system but the goal of this tutorial is a little bit different: "taste it". You know - it is not learn You good behaviors but allow to watch new tool in many, different scenarios and check how it works. It is like You see a cake made from different ingredients and You can taste piece of cake - and stated that you like it and you want to know more about this cake and each ingredients used there. It is very good for people which are not convinced to something but they at least want to try it and look how it works. The "lab" form is good because this is something less convenient and boring then standard tutorial - but it is still "step by step" way when you can go forward doing baby steps and repeat last step if somethings go wrong. Third approach in the basis part are the same as the second but it is more interactive. It free learning person to install something inside system, and avoid issues related with treshold where something goes wrong and you can not fix this - and local guru is not available or you do not have one. On-line environment remove this potential barrier and makes course much more interactive. It is closer to the game then programming language. And it is fun. Forth link is complete revolution in why how You can think of "learning". It is extremely interactive and person "learn by play". As third part you do not force person to start creating local environment but also makes learning process extremely fascinating and absorbing. There is no big difference between "game" end Sokoban levels or pass all labs of course. It is lowest learning curve, in the same time inculcating good programming behaviors, way to learn something someone. Especially when You are newbie. In my humble opinion - different people learn things in different way and there is no one good method to learn something from grounds.Good documentation in XXI century is definitly not enough today. People expect more interactive and fun way to learn something. That is why RubyOnRails get notability to be "cool". I think the way how we should think about learning programming language today is - to so interactive as it is possible and change the learning process for a play. That is all. I hope this hints will be helpful in terms of thinking how to learn someone pyramid from basis. Greetings from Poland! -- Jan Koprowski -- You received this message because you are subscribed to the Google Groups "pylons-devel" group. To post to this group, send email to pylons-devel@googlegroups.com. To unsubscribe from this group, send email to pylons-devel+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/pylons-devel?hl=en.
