Jennifer Hodgdon and I met at PNWDS and had a quick brain-dump about a plan. Here it is! I'll split these off into other sub-issues soon; just want a place to park this for now that's not an email. :)
We have the need of 4 main resources:
One D8 landing page to rule them all!
Somewhat similar to https://drupal.org/drupal-7.0 but expanded to cover specific target audiences, the idea is a single landing page that is widely publicized which helps answer FAQs like "what features are in D8?" "how do I upgrade to it?" "what documentation is available?" etc. and would point off to the resources down below. The Drupal.org Content Working Group is actively working on this, with an "end of Q4" target. I have a call with them sometime this week/next week to find out more.
For now, this is going to happen at https://drupal.org/drupal-8.0 and there are some content notes there. Later, there will be a really nicely designed site for this information.
Re-organized "Develop for Drupal" section
https://drupal.org/documentation/develop is a mishmash of D6, D7, and D8 code with no clear delineation of what applies to which version. While what we ultimately need is some means of cleanly identifying this from the backend side, lacking that infrastructure (which hopefully can be worked on once d.o D7 launches which is "soonish"), it really doesn't feel like this can wait. Drupal is currently inaccessible to grok for new people, so we need a place where we can work on making this more accessible RIGHT NOW.
What Jennifer recommended was adding D6/D7/D8 sections underneath both https://drupal.org/developing/modules and https://drupal.org/developing/api and moving the pages beneath that describe individual components to wherever the latest version they apply to is. The other pages should get pointers over to it, and in the case where the text applies 80% to D7 except for one part, add a paragraph denoting this. This would get us started in the direction of contextual versions without needing code changes.
Somewhere in here, I'd also like to incorporate the nice work that was done on the D8 community video curriculum lesson outline at https://github.com/xjm/d8_videos, and in the sub-pages add a "resources" section for now that points to good blog posts/presentations on these topics to at least get *something* started that people can add to. I feel like once this framework is in place, we can probably crowd-source at least some of the raw authoring work. In any event, we can definitely cross-link the videos/tutorials for those things once they're available.
Revamped "Contribute to Drupal 8" section
https://drupal.org/community-initiatives/drupal-core was useful up until feature freeze, but since then it's sort of lingered and is no longer reflecting what people are actually working on and where we really need help. I want to revamp this to provide things like a "countdown" of critical issues, pointers to tools like Examples module, Coder Upgrade, etc. where people can jump in and help port those, and a weekly or so "hit-list" of the most important issues we need eyeballs on, regardless of the initiatives. I mothballed the current page under "Previous / Inactive initiatives" at https://drupal.org/node/2107085 since for the most part these initiatives either happened already or aren't happening for D8 after all.
Revamped and expanded api.d.o landing page and "Topics" list for D8
Right now if you go to https://api.drupal.org/api/drupal/8 (which most people will) there's nothing remarkably different about this page than any other Drupal versions, and it's lacking pointers to huge changes in D8 like services, dependency injection, plugins and annotations, etc.
I've created a separate meta issue for this at: