Problem/Motivation
When looking at the card view of a project in the project browser, there is a wrench icon that appears, whose intention is to convey the concept "actively maintained," which is somewhat of a Drupalism but also not necessarily intuitively obvious from just a wrench.
Proposed resolution
1. re-introduce the old wrench icon (I do not agree that a gear is the right thing here, it's too easily confused with "configure" or "settings")
2. place the wrench icon on the cards for modules whose maintenance status matches our default filter (that is, you get the wrench if you are actively maintained or seeking co-maintainers or minimally maintained)
{ 3. (this is already in a separate issue) introduce a legend to clearly explain what the icons mean, without relying on pulling down a filter, etc. see related #3282163: Improve iconography usability by adding a legend }
| Comment | File | Size | Author |
|---|---|---|---|
| #37 | Same_sized_icons.png | 95.56 KB | utkarsh_33 |
| #36 | Screenshot 2024-10-17 at 5.18.23 PM.png | 95.28 KB | utkarsh_33 |
| #27 | Screenshot 2024-05-15 at 1.46.42 pm.png | 24.57 KB | pameeela |
| #16 | Screenshot 2022-07-04 at 11.05.40.png | 40.33 KB | fjgarlin |
| #16 | Screenshot 2022-07-04 at 10.57.57.png | 9.65 KB | fjgarlin |
Issue fork project_browser-3267678
Show commands
Start within a Git clone of the project using the version control instructions.
Or, if you do not have SSH keys set up on git.drupalcode.org:
Comments
Comment #2
fjgarlin commentedMaybe it should follow the same icons that are used on d.o?
* For minimally maintained it’s a grey triangle.
* For actively maintained there is no icon.
Current icons can be found here: https://git.drupalcode.org/project/drupalorg/-/tree/7.x-3.x/drupalorg/im...
(I don’t think there is a grouping for the different maintenance statuses)
And the logic for the icons is here: https://git.drupalcode.org/project/drupalorg/-/blob/7.x-3.x/drupalorg_pr...
(no icon for actively maintained projects, then grey triangle or alert triangle for minimally maintained and no longer maintained)
Comment #3
leslieg commentedWould adding a legend be an option for letting users know what the icons represent? Tooltips were our original thought, but have accessibility issues. A legend would allow us to put the combined statuses of "Actively maintained or Minimally maintained"
The legend could display where we used to have the text explaining the default options.
See attached file - DefaultFiltertext.png
Comment #4
leslieg commentedComment #5
fjgarlin commentedI think that's exactly what this other issue was created for: https://www.drupal.org/project/project_browser/issues/3282163
Comment #6
chrisfromredfinYeah, let's keep legend discussion in the other issue. BUT, I think this issue is still for potentially fixing the "wrench" icon to something else. HOWEVER, we now have another icon in the Figma that I really like, which is that gear with code brackets in it. DOUBLE HOWEVER, I think that icon makes the most sense for development status, not maintenance status. Do we want to do three icons, with that, and a legend? I think that's the right solution. :)
Will call UX folks' attention onto this one also in Slack.
Comment #7
fjgarlin commentedRelated issue and comment: https://www.drupal.org/project/project_browser/issues/3281218#comment-14... (as in decisions in this issue will affect the other or viceversa).
Comment #8
chrisfromredfinComment #9
tim.plunkettIf this issue is different than #3282163: Improve iconography usability by adding a legend, can the issue summary be updated?
Comment #10
tim.plunkettChris clarified, thanks!
Comment #12
fjgarlin commentedCode looks good and new icon is shown. Icons order also match the one of the filters. Marking RTBC.
Comment #13
bnjmnmThe two icons look odd next to each other due to the maintained gear icon occupying the full width/height of it's canvas while the blue security shield has space (basically padding) on each side that is roughly 12.5% of the total width/height. If the maintained gear had similar "padding" in it's canvas, the two icons would look much better next to one another.
Comment #14
bnjmnmComment #15
tim.plunkettThat's a very good point! However, I don't know how to do that. I grabbed those directly from Figma
Hoping someone else can figure it out
Comment #16
fjgarlin commentedI don't have access to the figma pinned in the #project_browser channel.
I was playing around with an online SVG editor with different paddings from the image that Tim originally added to this MR. This version is what feels the most consistent. Adding more padding to the sides will make one icon taller than the other.
See results:

Comment #17
bnjmnmI think this should get postponed on (the similarly named but I assure you it is different) #3294608: Consider replacing "actively maintained" icon. This issue seems to be iterating on an icon that @drumm has broader concerns about it being in the UI at all.
That may also justify removing this as an MVP requirement, but I don't want to singlehandedly make that call and remove the tag.
Comment #18
tim.plunkettComment #19
chrisfromredfinComment #20
chrisfromredfinNeed to revisit this.
Comment #21
tishmgI'd like to work on this. #Portland2024
Comment #22
tishmgMy input on wrench vs. gear: a wrench icon to me implies heavy work, like under construction, vs. a gear, which seems to imply a smoothly running machine. The gear seems to be a better fit for actively maintained to me. A wrench would seem to apply that the module needs a lot of work.
Comment #23
dblanken commentedI did not immediately get the impression that the gear or the wrench meant "maintained". I'm wondering if you can somehow convey it with a silhouette of a person to convey it's maintained by a person? Person with a hammer? Or the gear with a person silhouette inside?
Comment #24
mtulloHello! Just some UX two cents here. My initial thought with a gear icon is settings and with a shield icon is security. If we were to go in a different direction than these two I would suggest something with a person avatar that is either holding a tool or on a computer to indicate that there is a human maintaining this.
Comment #25
johnpicozziI'm going to be honest, I'm not sure if a wrench or a gear really matter. The larger issue is educating the user as to what the icons means. I have discussed not using a legend (#3282163: Improve iconography usability by adding a legend) and adding a tool tip (#3293909: Security and maintained icons need to communicate correct information). I tend to agree that a wrench might be better than a gear based on the above comment of a gear being associated with settings.
Comment #26
chrisfromredfinComment #27
pameeela commentedI think this is a really, really hard thing to covey with an icon! It is interesting that there are people strongly in favour of both. I don't see either one as being very indicative, and agree with #25 that the icon itself probably won't achieve much either way.
Coming into this issue I did not know what the blue check icon meant either, but looking at PB I was able to determine from the filters that it means 'Covered by a security policy'. However, given that this is also a default filter, I am not sure the icon is a good idea? It will add clutter to the UI, considering that every module will have it by default. So I guess the use case is someone who selects 'Show all'?
I think it would probably be better to add an icon if it's *not* actively maintained, as this is something to alert users to. Otherwise, nothing to see here. And I see now this was already suggested in #2!
Screenshot of the filter for reference:

Comment #28
bnjmnmComment #29
poker10 commentedI am curious if we can check some d.o. statistics about "Maintenance status" and "Development status" in comparision with gitlab commits. It can be interesting to see how many modules are Actively maintained and/or Under active development and have no commits for a longer period (or similar).
I often see that these two values does not reflect the reality in many modules (would say that maintainers set them mostly when creating a module and then never update it). Certainly there are exceptions and lot of modules has this set correctly, but the question is if it does not get too much space, so that the module maintainers will be abusing this to get the "icon".
Comment #30
narendrarHi @Chris, while looking at the projects, I don't find
wrench icon. Is this issue still relevant?Comment #31
chrisfromredfinI think we removed the wrench icon that used to be there because of this issue, and not wanting it to appear inside the filters (old UI) because it messed up responsiveness of the filters.
I do believe we need to re-introduce an icon for "well-maintained." I understand that most maintainers probably set it and forget it, but I think some of the point of project browser is to encourage maintainers to do more tending to their garden. So I am inclined to say we need to do the following:
1. re-introduce the old wrench icon (I do not agree that a gear is the right thing here, it's too easily confused with "configure" or "settings")
2. place the wrench icon on the cards for modules whose maintenance status matches our default filter (that is, you get the wrench if you are actively maintained or seeking co-maintainers or minimally maintained)
3. (this is already in a separate issue) introduce a legend to clearly explain what the icons mean, without relying on pulling down a filter, etc. see related #3282163: Improve iconography usability by adding a legend
Comment #32
chrisfromredfinComment #33
utkarsh_33 commentedComment #34
utkarsh_33 commentedI'll ask @tim.plunkett to change the target branch to 2.0.x as i don't have the permission of doing that and then maybe work on this to get it more refined.
Assigning it to Tim for above mentioned task.
Comment #35
tim.plunkettRe-targeted!
Comment #36
utkarsh_33 commentedThis still needs some CSS fixing as there is a difference in heights between the 2 icons.

Comment #37
utkarsh_33 commentedNow the icons are of the same size as you can see in the attached screenshots.

Comment #38
utkarsh_33 commentedThis now has some work align to what @chrisfromredfin mentioned in #31.Marking it needs review.
Comment #39
utkarsh_33 commentedMerged the latest changes in 2.0.x.
Comment #40
leslieg commentedAfter manaull testimg I can confirm that the wrench icon appear on the correct place on the card when the Project is maintained and does not display when the project is unsupported.
Needs a code review
Comment #41
lostcarpark commentedI've reviewed the code, and I've queried one thing. I think at present, a module will only showed the maintained icon if it is also covered by the security policy.
I've tried testing manually, but at present I'm only seeing data if I turn off the "maintained" filter, so I think there may be an issue with the back end at present, but because of this I wasn't seeing any "maintained" icons. I think this is a data issue rather than an application issue.
Comment #42
utkarsh_33 commentedI have created a follow-up issue Include the wrench icon on the module's detail page.
All the feedbacks are addressed and the test fails are not related to the changes in this MR, keeping the status as NR as this is blocking Improve iconography usability by adding a legend therefore also increasing the priority for this issue as both are Beta blockers.
Comment #44
chrisfromredfinThanks for the resurrection! This will unblock two more issues, so those are cleared to go now.