At DrupalCon SF 2010, Dries made the statement in his keynote that there are 19 distributions of Drupal. Yet there is no place where the 19 distributions are listed on a single page with a name, brief description, and a link to the page which is dedicated to that distribution.
There is a Drupal handbook node Home » Getting Started » Understanding Drupal » Third party resources » Drupal distributions. This would appear to be the place where that list of 19 distributions belongs, but it has something almost completely different.
I am suggesting changes to that page as follows:
--- Introduction section ----
Current text:
Information on quick pre-configured Drupal installations, usually including a selection of modules.
Issue with current text:
Someone landing at this page from a link rather than from reading the Understanding Drupal handbook has no context on what a distribution is.
Suggested text:
A distribution is as pre-configured Drupal installation. It contains the core code and usually contains a selection of modules. A distribution allows a webmaster to quickly set up a Drupal-powered website without having to make a lot of decisions about which modules to include, and without having to find and download each module individually.
--- at Drupal.org section ---
Current text:
At drupal.org:
* Installation profiles - Customized "distributions" that enable and configure a set of modules that work together for a specific kind of site.
* Distribution profiles - Drupal group.
Issues with current text:
There appears to be significant differences between an installation profile and a distribution. Since the idea of a distribution profile is that you don't have to do it yourself, and there is a lot of do-it-yourself in an installation profile, it would be better if installation profiles weren't even mentioned on node 326175.
As for the link to the Drupal Distributions group, that is discussions about distributions. One has to hunt for specific offerings of distributions among the various discussions.
Suggested content:
Rename section to "Distributions from Drupal.org"
List each Drupal.org distribution individually, including the core distribution. For each distribution that is available at Drupal,org, provide a distribution name, brief description, and a link to the page which is dedicated to that distribution.
--- other resources section ----
Issues with current content:
Current content contains a mix of sites and distributions. Some links go to site home pages, some to actual distribution pages. The link for DrupalEd goes to a placeholder page, so may be stale. Not everything is referred to as a distribution; this is also an issue at the third-party sites--I can't tell whether Pressflow is a distribution or a fork--but I recognize that Drupal.org is not responsible for the third party sites.
Suggested content:
Rename section to "Distributions from third parties"
List each third-party distribution individually. For each distribution that is available from a third, provide a distribution name, brief description, and a link to the page which is dedicated to that distribution, followed by the name of the third party distributor and a link to their home page.
--- Lists that might also facilitate an initial module selection: section ----
Rename section to "Customizing distributions"
Retain the current content, but add an introduction:
You may find that the core Drupal.org distribution or one of the other distributions listed on this page provide nearly what you want, but not quite. At that point, you can seek, download, and install additional modules. Here are some lists that might facilitate that additional module selection:
Comments
Comment #1
dave reidMoving to documentation issue queue. Please slap me is this is the wrong thing to do since this really isn't in the scope of webmasters.
Comment #2
arianek commentedtotally the right place dave, though it might be a while till we get to this! (like, until the d7 docs area actually up to date) this definitely sounds like a section that needs some work.
Comment #3
alex_b commentedIs every installation profile on d. o. a distribution? If yes, we have a lot more distros than 19. If no - when does an installation profile fulfil the characteristics of a distribution? If yes - why do we call http://drupal.org/project/installation+profiles still installation profiles? If no - couldn't all installation profiles be distributions? I don't have answers to these questions, but I think we need to address them in order to have clear documentation and UI.
Comment #4
dww"Is every installation profile on d. o. a distribution?"
No.
"If no - when does an installation profile fulfil the characteristics of a distribution?"
The working definition is that an installation profile that includes a drupal-org.make file and is packaged with core becomes a "distribution". I ran the queries to give Dries his data for that slide, and that was the criteria we used.
"why do we call http://drupal.org/project/installation+profiles still installation profiles?"
Because we decided not to completely rework all the project browsing and downloading functionality on d.o to highlight distributions as such until more of them existed and they were more worth the attention. At this point, it seems that the distributions hosted on d.o still haven't reached the critical mass or maturity to fulfill their promise as the primary entry point for most people starting out downloading Drupal. It's a bit of a chicken and egg problem, I'll admit.
"If no - couldn't all installation profiles be distributions?"
Yes. It just requires that the maintainer create (and ideally maintain and support) a drupal-org.make file so that their install profile is packaged as a full distribution.
Hope that helps clarify. I'm all for incremental improvements to these pages in the meanwhile. They really haven't been touched since all the changes went live on d.o to make distributions possible.
Comment #5
alex_b commented#4 - thanks for the clear answers. This helps.
Comment #6
arianek commentedadding tags
Comment #7
lisarex commentedI'll take a look at this, since docs here were recently updated and moved to http://drupal.org/documentation/build/distributions
Comment #8
arianek commentedyay great :)
Comment #9
jhodgdontagging the Distributions issues so the issue triage avoids closing this issue
Comment #10
lisarex commentedUnassign. I am swamped.
Comment #11
leehunter commented