1 of 42

What’s New with the

Project Browser Strategic Initiative

bit.ly/pbnedcamp22

2 of 42

Leslie Glynn

​

  • Manager Client Success at Redfin Solutions
  • Co-leader of the Project Browser Initiative with Chris Wells
  • Drupal Association Board of Directors 2019-2021

leslieglynn

leslieg

3 of 42

What is the Project Browser Strategic Initiative?

  • Announced by Dries at DrupalCon North America 2021

“The Project Browser makes it easy for site builders to find

and install modules.” - Dries

​

  • Driesnote DrupalCon Portland 2022
    • “want to be able to discover great modules from within Drupal,, without having to go to Drupal.org and install those modules with a click of a button “ - Dries

​

4 of 42

How do we help site builders find modules?

https://www.drupal.org/project/project_module

5 of 42

Project Browser Strategic Initiative

https://www.drupal.org/about/core/strategic-initiatives/project-browser

6 of 42

What problem are we trying to solve?

  • Creating a Drupal site is relatively easy (Try Drupal on Drupal.org). Then what?

​

  • One of the very first things nearly all new users attempt to do is find and install contributed modules to add functionality to their website

​

  • Modules page on Drupal.org reports there are 49,227 modules today

7 of 42

Goals: Initial MVP

  • Ability to browse modules compatible with the website’s Drupal version
  • Provide instructions for downloading and installing modules
  • Filtering by category
  • Advanced filtering with additional choices
  • Contrib module

8 of 42

Project Browser Contrib Module

https://www.drupal.org/project/project_browser

9 of 42

Try Project Browser using Gitpod

https://shaal-drupalpod-40apde9fnf6.ws-us59.gitpod.io

10 of 42

Your Gitpod site

11 of 42

First look at the Project Browser

12 of 42

What have we accomplished

  • listening sessions with our target audience
  • decided on default criteria
  • grid and list views
  • first cut at proposing descriptions for the categories
  • mock of default fetch from d.o
  • released a beta version of contrib module
  • allow multiple “sources” of data (drupal.org, core modules, private lists)
  • *** replaced install instructions with actual Composer commands ***

​

13 of 42

Project Browser Sources

14 of 42

Configuration to Select Sources

15 of 42

Automatic Updates Initiative

16 of 42

Package Manager configuration

17 of 42

Package Manager Issue with Symlinks

18 of 42

Package Manager installs dependencies

19 of 42

What are we currently working on

​

  • updating content on Drupal.org project pages for display on the card
    • starting with Top 100 modules- logo, proposed short description, categories
  • defining project detail pages - so far just have proof on concept in place
  • creating a base template to make the body field more consistent
  • reviewing categories
  • migrating from the drupal.org Mock API to the real Drupal 9 site
  • converting from Drupal CI to GitLab CI
  • making the Svelte side of the frontend more themable
  • getting maintainers involved

​

​

    • ​

20 of 42

Meta ticket for the Top 100 most popular modules

​

​

https://www.drupal.org/project/issues/project_browser?text=meta&status=1&component=Contrib+changes

Initially updating:

  • Logo
  • Project summary
  • Categories

21 of 42

Use Contrib Kanban to easily find issues to work on

​

​

https://contribkanban.com/board/ProjectBrowserTop100

22 of 42

Each Meta issue has three child issues

​

​

​

https://www.drupal.org/project/issues/project_browser?text=meta&status=1&component=Contrib+changes

23 of 42

Propose or review a logo

​

​

24 of 42

Propose a short non-technical description

​

​

25 of 42

Propose 1-3 categories

​

​

26 of 42

Where do you begin?

​

​

Needs work - Propose description, categories or logo

​

Needs Review - review what someone has proposed to see if it meets the requirements defined in the meta issue

​

Reviewed and Tested by the Community - Someone has done the review and decided the proposed resolution meets the requirements

​

Active - Do not work on things in this column. The Meta issues are listed there, work on the child issues

​

27 of 42

Project Detail pages

  • No consistency on Drupal.org
  • What is the most important information for site builders to make an informed decision?
  • Often more than one similar module

​

​

28 of 42

Project Detail page on Drupal.org

​

​

​

Template for Body - https://www.drupal.org/project/project_browser/issues/3230734

29 of 42

Project Detail page in the Project Browser

  • Skeleton only at this point - working on the plumbing - how to make the connections
  • View using Gitpod

​

​

30 of 42

Project Detail proposed information architecture

  • Need community input
  • What’s most important to help make decision on a module
  • How to best display the information
  • Need a wireframe or mock-up

​

​

​

31 of 42

Revisiting Categories

​

https://www.drupal.org/project/project_browser/issues/3240313

​

​

​

​

https://www.drupal.org/project/project_browser/issues/3311475

​

​

Review Category Proposal

32 of 42

Real Drupal.org API

Drupal Version

(9.4.x)

Categories

Drupal.org

Project Browser

Security Coverage

Module name

Description

Default fetch from d.o. currently mocked

​

Contributors and DA working on real D9 endpoint

​

Currently grabbing data nightly

​

Moving D.o to D9 piecemeal

​

Fields on d.o will stay the same

- maybe add a logo field

​

33 of 42

Dev Ops

​

      • converting from Drupal CI to Gitlab CI
      • session on from BADCamp by Irina Zaks
        • From Drupal CI to Gitlab CI - what, when and how

​

​

​

​

​

34 of 42

Front End

​

  • Check designs against Drupal design system
  • Proposal to make Svelte side of the front end more themable
    • Html rendered by svelte, not html
    • It’s built into the JS
    • Needed for core
  • Accessibility - reviewed current implementation with Mike Gifford and others
  • Meta issue for UX improvements

​

​

​

​

35 of 42

Goals: Looking forward

  • Project browser in “Core”
  • Expand to include Recipes - “Recipe/Distributions” initiative
  • adding an “Ecosystem” filter
  • expanding to search themes

36 of 42

Recipe/Distributions Initiative

37 of 42

Contribution Event

​

  • Yesterday at NEDCamp
    • Test the latest version and give feedback
    • Give feedback on improving the Project detail pages - what is most important for you to see when selecting modules
    • Contribute to realigning the categories
    • Add logos, short descriptions and categories to modules
    • Testing the package manager integration
  • Everyone welcome - designers, ux, accessibility, testing, documentation, site builders, beginner feedback, back end and front end coders,
  • Current maintainers welcome

​

38 of 42

Why should you contribute to Project Browser?

​

  • help improve one of the first experiences for new users after installing Drupal
  • current Drupal.org module page is overwhelming and not easy to use
  • opportunity to add consistency across project pages
  • chance for site builders and those new to Drupal to contribute
  • work with new tools like Svelte and GitLab CI

Contribution Opportunities

​

​

39 of 42

How can you join the initiative

​

  • Join #project-browser on Drupal slack
  • Join the Site Builder Subcommittee Meeting
    • Tuesdays 4pm ET
  • Join the General Meeting
    • Wednesdays 10am ET
  • Work on Issues noted on previous slides
  • Check the issue queue

​

Thanks to all who have contributed

40 of 42

Reach out to the initiative leads with questions

​

​

​

@chrisfromredfin

@leslieg

​

Join the #project-browser channel on Drupal Slack - drupal.slack.com

41 of 42

Resources

​

  • Driesnote DrupalCon North America 2021 - Announcing the Project Browser Initiative

​

  • Driesnote DrupalCon Portland 2022 - Drupal 11 - Project Browser https://www.youtube.com/watch?v=Ig676RzJbLo The Project Browser section starts around 44 minutes

​

​

  • Project Browser module page

​

​

​

​

42 of 42

Q & A

​

​

​

Questions?