Closed (fixed)
Project:
Documentation
Component:
Placement/Navigation/Structure
Priority:
Normal
Category:
Feature request
Assigned:
Unassigned
Reporter:
Created:
14 Jun 2011 at 23:47 UTC
Updated:
15 Mar 2012 at 23:20 UTC
While working on http://drupal.org/node/1087102 I realized that this page is just getting too long. The main requirements page needs to cover all the basics, and just the basics.
I propose that we take the following sections and make them their own child pages to http://drupal.org/requirements
This would allow those sections to grow larger without having the user scroll through one giant monolithic page.
If this is accepted as a good idea I can take care of creating the new pages and migrating all the content.
Is this a good idea?
Comments
Comment #1
pillarsdotnet commented+1
Comment #2
arianek commentedI'm not so keen on splitting up this page. There are a series of steps to setting up the requirements, and they really are all necessary (not optional) which seems more appropriately put all in one place.
Comment #3
jhodgdonI'm not in favor of splitting the page either. Someone who is going to install Drupal needs to know about all the requirements. Splitting the page up means that they need to click around more, and it makes the top level page pretty much have no content. I don't see the benefits of splitting it up, and I do see the down-side.
Comment #4
leehunter commentedI've got a slightly different take.
I'd agree with the OP that the page is starting to get a bit ugly. But it's mostly because it's wandered well beyond describing system requirements and has become a place to collect all sorts of tweaks and settings, especially for PHP.
A System Requirements page is usually a very succinct bulleted list of the required environment and nothing more. All the stuff about configuring PHP should be in a separate page (with a cross-reference from the requirements page).
Comment #5
jhodgdonI'm not sure I agree. Most or all of the PHP settings described on that page are not at the level of "tweaks", but actual requirements needed to run Drupal. Just because you have the right versions of Apache, PHP, and MySQL doesn't mean Drupal will run on that system, with all of its features working.
Comment #6
leehunter commentedI've rejiggered the PHP section a bit to separate out the general requirements from the version-specific requirements. Maybe that's enough to keep the page from being overwhelming.
Comment #7
jhodgdonThat looks pretty reasonable to me. There may be some missing open UL tags or something -- the formatting is a bit off -- but nothing standing in the way of understanding or scanning the page IMO.
Comment #8
leehunter commentedI've cleaned up the UL tags (I hope).
Comment #9
matthews commentedI think this page is easy to scan - and is makes sense. I'm going to set it to RTBC.
Comment #10
jhodgdonStill looks fine.