Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.This is really bugging me. An itch that I can't scratch and I believe it causes confusion.
This page: http://drupal.org/project/modules
Contains both modules and themes - It should only have modules OR the title/intro paragraph needs to be changed.
This page: http://drupal.org/node/206666
Contains both modules and themes - It should have only modules OR the title/intro paragraph needs to be changed.
I have brought up the issue of projects vs. modules to the drupal infrastructure group.
http://groups.drupal.org/node/21925 - they agree it is confusing
What I want to do:
I want to create separate pages for the documents and the themes, by core release if needed.
What I need:
Access to the actual page information so I can clean it up in a word processor and ship it back to be included in documentation
What the long term solution should be:
Auto generation of both of the pages, using a view with an exposed filter to limit the list to a core release and a type of project (module/theme/translation/etc)
Since the long term solution requires coding and significant changes to the page creation for these pages, I believe a short-term solution would be to clearly differentiate the types of projects by putting them on separate pages. As a relatively new Drupal user, it has taken me several months of staring at this before it finally dawned on my WHY the terms projects and modules seem so confusing.
Comments
Comment #1
add1sun CreditAttribution: add1sun commentedFor the intro text on http://drupal.org/node/206666, it is set to documentation format so you should be able to edit the text, we just can't edit the list itself. The list of projects is generated in a custom query in the drupalorg module. If you want to split out/modify the listings themselves, then you need to check out a copy of drupalorg module from CVS (it's in contrib like all other modules http://cvs.drupal.org/viewvc.py/drupal/contributions/modules/drupalorg/), modify the queries and supply a patch.
I assume that the main Modules landing page is generated by project module. That page only seems to be listing modules as far as I can see. I don't see any themes in there.
Comment #2
bekasu CreditAttribution: bekasu commentedthanks very much.
Well, looks like its time for me to move to the next level.
I'll be figuring out CVS (yikes!).
Thanks for pointing me in the right direction.
Comment #3
jhodgdonUmmm... I think there might be a bit of confusion here. I went and read your post on groups.drupal.org...
I don't think that there is anything but Modules listed on either http://drupal.org/project/modules or http://drupal.org/node/206666 -- neither of those pages should include any themes. If there are themes on either page, that would be a bug, so please point out which items you think are themes, and we can get that fixed. Add a comment here first so we can investigate the reason.
A separate issue is that the text at the top of http://drupal.org/project/modules says;
That is I think the source of some of your confusion -- it should probably say:
You can also view an alphabetical list of modules that includes only the names (and only the names) of all modules, by version.
If you would like to see this changed, please file an issue in the "Drupal.org webmaster" project, ask them to change the text, and explain why it is confusing you.
As far as your other confusion about URLs and "module" vs. "project", hopefully your confusion has been somewhat cleared up. I will add an entry for "project" to the terminology page in just a minute (first I need to restart my browser, though, as it is behaving strangely). Hopefullly that will help. The URLs are unlikely to change ever.
If you have other problems with how the terms "project" and "module" are being used in documentation pages, please note them here. Otherwise, maybe you can mark this issue as "fixed", if it is fixed to your satisfaction. Thanks!
Comment #4
bekasu CreditAttribution: bekasu commentedOk .
I went back as you suggested and reviewed each of the theme entries on the pages.
I'll say that I was thinking too 'black and white'. The 'gray' was muddying the waters.
In my mind, themes and theme-related modules should be on the same grouping. Theme-related modules have no value unless you plan to incorporate more than 1 theme on your site; ergo, I assumed (shame on me) that theme related modules are really more usefully grouped with themes. In reality, this goes against my original thought process trying to queue off the word module and project.
So, although the description of the module appears to indicate it is a theme, it really isn't. Since we don't currently provide an exposed filter to let the user decide what category of projects they are looking for, we perpetuate the separation as is.
Okay -- so basically i need to help figure out a way to convert the pages to views and to add in exposed filters (long-term solution).
Short-term solution - ask the webmaster to change the verbage on the 'modules' page so it says modules instead of projects AND I need to quit being so literal.
Thanks for the addition of the word projects to the glossary and more specifically for taking time to re-orient me in this Drupal world.
I'll ask the webmaster to make the change and mark this fixed.
Comment #5
jhodgdonJust one more note on this, in regards to filtering the list of modules and finding modules.
When you go to the Modules page (drupal.org/project/Modules), there is a sidebar block ("helpfully" labeled "Projects" -- you might want to include this in your webmaster request and explain why this is confusing). By clicking on a link there, you can filter down the list to modules in those categories (noting that some modules may appear in more than one category).
There's another sidebar block that lets you filter by version compatibility. And a third that lets you search within modules.
Another navigational possibility (though it doesn't list all modules) is to go to the "Contributed Modules" page in the Getting Started handbook (http://drupal.org/node/340271), and click on "Comparisons of contributed modules" or "Contrib module documentation" to find modules. I'm also going to add the above navigational hints to that page, as I think others may not know about them or notice them.
Hope this helps you in locating modules.
And thanks for bringing this up -- those of us who have used Drupal and drupal.org for a while don't sometimes realize/remember how confusing it can be for newcomers.