SORRY ABOUT ABOVE CUT OFF! -- I went to Chipolte.com and Flash caused Safari to crash. I'm sure Steve would love to hear that. Back to my post
I am a web developer. I came to wordpress.org because I am interested in integrating the wordpress framework into my existing site. I found it to be a frustrating experience (the learning part), mostly because at wordpress.org it was hard to find the information I wanted.
I see it this way: WP basically has two customers
1) The person who knows nothing about web development. The "layman"
2) The experienced web developer. The "developer."
The information WP displays to these two (very different) customers (regarding use / integration) should be very different. For example, all of "the Loop" lingo is laughable to a developer, yet I understand it is completely necessary for the layman.
What I would LOVE is a "How WP works. How to use it. How to integrate it." page that is split into two columns
COL 1: <h1>I know nothing about web development. Speak my language.</h1>
COL 2: <h1>I know PHP, MySQL, CSS, HTML,... give me the real deal.</h2>
And from here, the "layman" and the "developer" are directed to different pages written with a completely different tone / vocab / etc. Being a developer, I would love to see a simple API-like set of methods / classes / etc with examples that show how to integrate the WP framework into my existing site. I mean, really, what developer wants to use a canned WP template? Probably not many. So this information should not be front and center.
That said, the layman doesn't ever want to see the words "class" "method", etc. They care about templates, themes, blah blah.
Anyways, this distinction wouldn't be hard to make, and I think it would help BOTH types of WP customers by hiding the information each of them are not interested in reading.