Commit d805ed7b authored by alexpott's avatar alexpott

Issue #2268467 by fago: Document foreseeable changes to conditions and action APIs.

parent 2c11d0ea
......@@ -9,6 +9,9 @@
/**
* Interface for context definitions.
*
* WARNING: This interface is going to receive some additions as part of
* https://www.drupal.org/node/2346999.
*/
interface ContextDefinitionInterface {
......
......@@ -13,6 +13,22 @@
/**
* Provides an interface for an Action plugin.
*
* WARNING: The action API is going to receive some additions before release.
* The following additions are likely to happen:
* - The way configuration is handled and configuration forms are built is
* likely to change in order for the plugin to be of use for Rules.
* - Actions are going to become context-aware in
* https://drupal.org/node/2011038, what will deprecated the 'type'
* annotation.
* - Instead of action implementations saving entities, support for marking
* required context as to be saved by the execution manager will be added as
* part of https://www.drupal.org/node/2347017.
* - Actions will receive a data processing API that allows for token
* replacements to happen outside of the action plugin implementations,
* see https://www.drupal.org/node/2347023.
* - Actions will have to implement access control for checking who is allowed
* to configure or perform the action at https://www.drupal.org/node/2172017.
*
* @see \Drupal\Core\Annotation\Action
* @see \Drupal\Core\Action\ActionManager
* @see \Drupal\Core\Action\ActionBase
......
......@@ -28,6 +28,17 @@
* @todo Replace the dependency on \Drupal\Core\Form\FormInterface with a new
* interface from https://drupal.org/node/2006248.
*
* WARNING: The condition API is going to receive some additions before release.
* The following additions are likely to happen:
* - The way configuration is handled and configuration forms are built is
* likely to change in order for the plugin to be of use for Rules.
* - Condition will receive a data processing API that allows for token
* replacements to happen outside of the plugin implementations,
* see https://www.drupal.org/node/2347023.
* - Conditions will have to implement access control for checking who is
* allowed to configure or perform the action at
* https://www.drupal.org/node/2172017.
*
* @see \Drupal\Core\TypedData\TypedDataManager::create()
* @see \Drupal\Core\Executable\ExecutableInterface
* @see \Drupal\Core\Condition\ConditionManager
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment