When I ran the new contributors' BoF @ DrupalCon SF, the most-asked questions were about how to get a development environment up and running. There was a lot of analysis paralysis going on as would-be contributors tried to parse the huge amount of info available and decide what tools to use, then figure out how to set them up.

I'm working with sepeck, Heine, and realityloop to get OS-specific guides put together for a good basic dev environment. The same thing won't work for everyone, but by giving new devs a starting set-up that they can use, then audition replacements for tools that don't suit them, we can get them contributing sooner, and keep them from stalling in analysis paralysis for so long they give up and wander off.

I'll add the os-specific guides to the Development tools section (as their own sub-section) and then start thinking about how best to clean up and organize the rest of the "development tools" and "local server set-up" sections. Heads-up on ongoing efforts I should try not to step on the toes of, or ideas on how to make those sections more useful are needed and welcome :)

Note: Settled on "other" as the component since this is new docs, and clarification, and placement/navigation -- my brain gave up choosing between them. ;)

Marked novice because new contributors' ongoing feedback is needed to make sure we get this right.

Comments

arianek’s picture

Component: Other documentation issues » New documentation
Category: task » feature

gonna move this to feature request/new docs, because i think it would suit well the type of thing @bmann and i were chatting about in relation to the install guide... a "quickstart" guide!

so alongside the install guide's long format http://drupal.org/node/628292 there is currently a "quick install for experts" and i'd also like to add a "quick install for newbies".

i'm wondering if the same thing wouldn't be a good plan for the local install instructions?

mallezie’s picture

Component: New documentation » Correction/Clarification
Status: Active » Reviewed & tested by the community

Isn't this fixed in the meantime by
http://drupal.org/setting-up-development-environment

Setting to RTBC, to get issue closed.

leehunter’s picture

Status: Reviewed & tested by the community » Fixed

Status: Fixed » Closed (fixed)
Issue tags: -Novice, -handbook

Automatically closed -- issue fixed for 2 weeks with no activity.