Problem/Motivation

There is very little documentation currently on how third-party settings work.

  • ThirdPartySettingsInterface has only this high-level documentation:

    Interface for configuration entities to store third party information.

    A third party is a module that needs to store tightly coupled information to the configuration entity. For example, a module alters the node type form can use this to store its configuration so that it will be deployed with the node type.

  • ConfigDependencyManager has the most thorough documentation on dependency management, but only mentions third-party settings in passing.
  • The config dependency handbook page is not complete and does not mention third-party settings at all.
  • The config schema handbook page has one example for third-party settings.

Proposed resolution

Remaining tasks

TBD

Comments

xjm created an issue. See original summary.

xjm’s picture

Issue tags: +documentation

Version: 8.2.x-dev » 8.3.x-dev

Drupal 8.2.6 was released on February 1, 2017 and is the final full bugfix release for the Drupal 8.2.x series. Drupal 8.2.x will not receive any further development aside from critical and security fixes. Sites should prepare to update to 8.3.0 on April 5, 2017. (Drupal 8.3.0-alpha1 is available for testing.)

Bug reports should be targeted against the 8.3.x-dev branch from now on, and new development or disruptive changes should be targeted against the 8.4.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.