Documentation

We're getting some great feedback and collecting some amazing pieces to be used in documentation, and I'm looking to start aggregating this into a single place. I'm not positive I'm the one to do this so speak up if anyone has a better plan.

What I'd like to start doing, structured around the lessons. Is the folowing process.

Pre-lesson:

A) Collect all the handbook pages, api.drupal.org pages, and various tutorials found around the web to a single place (a thread here). This will constitute 'pre-reading' for anyone who wants it, so that we can go into the lessons with a better idea of what to expect.

B) Anyone who can should point out vague areas in the documentation before the esson - this will give josh_k and company some input as to what needs clarification from an xpert.

Post-lesson

A) Start the feedback thread as we did this time.

B) Start the wiki of the class notes as VicktorKane was nice enough to do this time around.

C) Roll all the 'pre-reading', screen-casts, audio logs, and outside web tutorials back into a handbook page - perhaps ust a revision of an existing handbook page.

To me, this creates a product outside the dojo that we can point to when we get new users who want to catch up.

Also, and perhpaps more importantly, it clears the waters of the drupal handbook. The documentation team doea an amazing job, but it would be impossible for them to create the type of Robust lessons that we are creating as simple record-keeping. Adding a screencast and audio to the handbook (perhaps not hosted on d.o), would be a huge benefit. Also, rolling disparate tutorials and handbook pages back into a more reduced - clear version, would help a lot of new users out.

Thoughts?

As soon as I can I want to start doing this retroactively for the first lesson. To that end...

Anyone interested in this effort should read this to start: http://drupal.org/node/14279

More threads on Forms API:

http://drupal.org/node/37775 - and its children
http://jeff.viapositiva.net/drupal/dynamic-forms
http://natrak.net/node/330
http://www.lullabot.com/articles/forms_api_2_0_cheat_sheet - this one is priceless -
http://www.drupal.org.uk/forms - and its children
http://drupalcon.org/node/31
http://www.hiveminds.co.uk/node/923 - worthwhile? - need to read the reasoning further.

Add to these in comments and I'll roll it back into the body of this.

Finally, this is a bit of a monumental task - I don't know that I can do it weekly, as it involves a lot of reading, and editing, and getting involved. At the moment, the only 'solution' I have to that, would be a two o three team effort where team A oes week one, four, seven, etc... although first let me guage interest. ..