Problem Statement

The navigation on new.drupal.org is visually clean and modern, but it is missing two elements that materially impact usability, especially as the site’s information architecture grows.
1. The site does not display breadcrumbs, which makes it difficult for users to understand where they are within the site hierarchy or how they arrived there.
2. When a user enters a section such as “AI”, there is no section-specific sub-navigation. This works for shallow structures, but it does not scale to more complex groupings of pages. Users cannot easily move laterally between related pages or understand the structure of a topic area.

As more topic areas expand, the absence of sub-navigation becomes a barrier to discoverability and orientation.

Proposed Solution

Look at the existing structure at
https://www.drupal.org/about/starshot/initiatives/ai
This section uses a right-rail navigation that exposes the sub-pages related to the AI initiative. The sub-navigation is persistent across all pages in this cluster, allowing users to move smoothly within the section and maintain an understanding of where they are.

We propose implementing a similar section-level sub-navigation pattern for new.drupal.org, along with breadcrumb support. This would improve orientation, reduce friction when moving between related pages, and support richer information architectures as the site evolves.

Expected Benefits

• Clearer sense of place through breadcrumbs
• Better wayfinding within complex topic areas
• More consistent experience compared to established Drupal.org patterns
• Improved usability for new contributors, evaluators, and stakeholders

Additional Notes

This request is not about redesigning the primary navigation. It is focused on restoring expected secondary navigation patterns that Drupal.org already uses successfully and that users rely on for orientation.

Issue fork drupalorg-3562062

Command icon 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

matthews created an issue.

drumm’s picture

We do have this planned and partially implemented, but have not had a chance to prioritize this work.

drumm’s picture

The section navigation block code is now merged. It needs a lot of theming, potentially a new block region to place it under the main navigation. The next step will be a bluecheese followup to do that, and follow up here to fix anything we missed.

The theme does display breadcrumbs when Drupal sets them, so we can get into specific examples. I think that should wait until the section navigation is deployed, so we aren’t preemptively solving problems that will shift as we change the menu use.

  • drumm committed 5e41769d on 1.0.x
    feat: #3562062 Add the section navigation block
    

  • drumm committed 5e41769d on remove-guides
    feat: #3562062 Add the section navigation block
    

  • drumm committed 5e41769d on doc-cache-fix
    feat: #3562062 Add the section navigation block