I don't normally look at this page, because I know what Drupal needs to get running:

http://drupal.org/requirements

The 'Resouces' section (the first) tells me that I need 32M to 90M of memory, it doesn't mention that this is the PHP memory limit (I assume it is!) In fact this mention of memory is well before any mention of PHP. In that section too, it mentions MAMP, why? We should remove that.

The Resources section needs a tidy!

Comments

bekasu’s picture

bekasu commented

Steven,
You are correct that the page needs some love.

I've been folding comments into it for a few days and have more to go. If you see things that could be improved, please feel free to edit the page. Help is welcome.

Not sure about the MAMP reference, I thought we had moved all those specific installers (mamp, lamp, wamp) to child pages. I'll look into it.

bekasu

arianek’s picture

arianek commented
Status: Active » Needs work

just updated the page status to "needs updating"

steven jones’s picture

steven jones commented

The MAMP bit was the in 'Requirements' section, I've removed it now.

The 'Requirements' section just doesn't say much really, it confuses more than it helps. I think it should be more of a bulleted list of what the requirements are. Webserver, capable of running PHP. DB. etc.

lp’s picture

lp commented

I realize the listed audience for the doc includes "Developers and coders," but this page is quite lengthy when compared to other software requirement lists:
(off the top of my head)
http://piwik.org/docs/requirements/
http://codex.gallery2.org/Gallery3:Requirements
and even the somewhat lengthy
http://www.mediawiki.org/wiki/Manual:Installation_requirements
not even gonna link to WP, because you really sorta already know what it looks like.

Would the server, DB & PHP requirements sections be appropriate for sub-pages?
Could they be better presented, with comments and updates specific to progress in those areas, ala the very specific MediaWiki PHP config page, which is linked to from the requirements:
http://www.mediawiki.org/wiki/PHP_configuration

arianek’s picture

arianek commented
Title: System requirements page, Resources section is confusing » Break Requirements page into subpages?
Issue tags: +developer

I do think it's important to keep all of the MAMP/WAMP/LAMP type requirements all in one place, so despite the page being fairly long, I think that it's pretty clear and appropriately arranged.

The one piece I guess could conceivably be moved is the specifics about the PHP settings. But I'd definitely want to get some others opinions on that before making the changes.

larowlan’s picture

larowlan
Location 🇦🇺🏝.au GMT+10
commented

What about an overview section at the top for the impatient, just a half dozen bullet points with a title like 'Overview' or similar? Most will read that and get what they're looking for. The bullet points can link to the detail in the text.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Status: Needs work » Needs review

I don't think an overview is necessary on http://drupal.org/requirements actually. I've added a table of contents to the top of the page, which I think will help. I think maybe the page is OK now... the original reported problem has been resolved, and I think the TOC helps. Thoughts?

arianek’s picture

arianek commented
Status: Needs review » Fixed

That looks good go me - marking fixed

Status: Fixed » Closed (fixed)
Issue tags: -developer

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

Issue tags: +developer

Restoring issue tags, see #2125755: System messages removed all issue tags during D7 upgrade.