Right, I guess I wasn\'t clear - I meant the RPi community needs to work on providing clear documentation, (not the hardware/Foundation folks...)
And agreed, but what I\'m hoping we as a group can do, especially if we\'re going to try to push this as a tool for helping get young people interested and excited about computing, is provide good clear documentation on the environment.
Think about it this way - when I bought my C64, it came with a fantastic spiral bound manual that explained all sorts of things about how the system worked, how to program for it in BASIC, what many of the poke addresses were, etc. Now, granted that was a MUCH simpler system than the RPi + Linux, but something that gives complete newbs the tools to get around and get started would be very good... Linux is WAY WAY more complex (and farther away from the hardware) than the old 8-bits most of us cut our teeth on, so it\'s going to take a lot more to get kids to really understand what\'s going on because there is so many more abstraction layers between them and the hardware these days.
In my mind I see a number of \"books\" that would be needed:
1) getting set up - covers hardware, creating/recovering a bootable SD card, etc.
2) intro to Linux - talk about the basic OS structure, kernel, steps involved in updating the kernel. Also talk about package management, makefiles, setting up user accounts, and sudo here.
3) intro to shell - give them the basic commands for getting around in a command line environment... probably Bash, but links to docs on others. Talk about environment variables, what they mean, basic VI/Emacs editing help, etc.
4) show them how to get set up with various programming languages - Python, Java, C/C++, Perl, etc. and point them to resources on how to start to program in each.
5) Get more into the hardware - how to interface with the GPIO pins, how to install drivers for printers or maybe a USB webcam... Or maybe even how to set up a USB thumb drive or portable USB hard drive for use as /home....
And so on...
That way it\'s somewhat lesson based, but also somewhat task-reference based. They can go for what they need when they need it, and can get as deep as they want but use these documents as the starting point to get them up and running and moving forward.