Improve the help page and convert the hook to OOP

Created on 21 May 2025, 2 days ago

System information

  • Drupal Core Version: ^10.1 && 11
  • Menu Migration Version: 4.0.1
  • PHP Version: >= 8.1 && <=8.3

Problem/Motivation

The current Help page for the Menu Migration module could greatly benefit from a revamp to enhance its user-friendliness and clarity for Site Builders and Developers. The existing documentation, while functional, can be improved to provide a more intuitive and accessible experience for users seeking guidance on module usage and configuration.

Furthermore, with the release of Drupal 11.1 and the introduction of the new object-oriented (OOP) hook implementation (as detailed in https://www.drupal.org/node/3442349 ), this revamp presents an opportune moment to modernise the module's help system. Adopting the OOP hook implementation for the help section would align the module with current Drupal development best practices, making it easier to maintain, extend, and contribute to in the future. This change would also serve as a practical example of the new hook system for module developers.

More here: https://www.drupal.org/node/3490771
And here: https://www.drupal.org/node/3498595

Steps to reproduce

1. Install the module
2. Navigate to the Help pages and click on Menu migration (Import & Export)
3. Observe the output

Proposed resolution

Move the contents of the help hook to a template, and apply design.
The menu_migration_help(), which at the time of writing is the only hook available in the module should be converted to an OOP hook in the process.

📌 Task
Status

Active

Version

4.0

Component

Code

Created by

🇷🇴Romania bbu23

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024