Problem/Motivation

Drupal core has a deprecation process documented here: https://www.drupal.org/core/deprecation

Extend documentation coverage for JavaScript since the document currently only covers PHP in its examples.

At the moment there's only single deprecation in our JavaScript code base, but it is likely that we would like to deprecate more of our APIs as part of JavaScript modernization efforts.

Proposed resolution

The deprecation process:

  • Mark the function as deprecated using @deprecated
  • Provide a function for triggering a deprecation warning. Provide way to suppress the warnings in environments where that is necessary.
  • Add change records for deprecated function explaining how to accomplish use cases without the deprecated function..

Remaining tasks

Comments

lauriii created an issue. See original summary.

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

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

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

lauriii’s picture

Status: Active » Closed (duplicate)
lauriii’s picture