When an API is deprecated the following message is added to it:

@deprecated in Drupal 8.0.0 and will be removed before Drupal 9.0.0.

This can lead people to believe that the API will be dropped during the 8.x.x release cycle rather than as during the 9.0.0 development cycle, e.g. from an alpha or beta release. A few of us discussed it on Twitter and wondered if the wording could be changed to e.g.

@deprecated in Drupal 8.0.0 and will be removed during the Drupal 9.0.0 release cycle but it is safe to continue using with future 8.x.x releases.


DamienMcKenna created an issue. See original summary.

JohnAlbin’s picture

How about the simpler:

@deprecated in Drupal 8.0.0 and will be removed with Drupal 9.0.0.


cilefen’s picture

"removed in Drupal 9.0.0"?

Wim Leers’s picture

"removed in Drupal 9.0.0"?

That is exactly what I was thinking, and what I've been doing in recent issues.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.