New Update on api.drupal.org Highlights Supported Drupal Versions

A new enhancement to api.drupal.org now helps users avoid outdated Drupal API documentation by clearly signaling whether they're viewing supported or unsupported versions. The change, developed during Acquia's 48Create internal hackathon on May 15–16, 2025, was led by Gábor Hojtsy and implemented in collaboration with maintainer Fran Garcia-Linares.

Previously, developers and even AI bots often landed on deprecated API documentation without realizing it. The new system displays version-specific messages: one for supported but outdated versions (like Drupal 10) and another for unsupported releases (such as 8.9.x). If a matching page exists in the latest version, users are directed there; otherwise, they’re sent to the version's index. A canonical link tag was also added to improve SEO and help search engines locate the latest content.

The feature leverages existing backend knowledge of preferred versions, extending it to track version support status. Inspired by Symfony’s documentation strategy, the update aims to boost developer productivity and accuracy.

Thanks to a demo script and local development tools like DDEV, contributing to api.drupal.org has never been more accessible. Gábor encourages others to build on this momentum.

Visit api.drupal.org to see the update in action or explore opportunities to contribute.