Issue #3103918 by greg.1.anderson, Mile23, alexpott, Mixologic, catch: [policy...

Issue #3103918 by greg.1.anderson, Mile23, alexpott, Mixologic, catch: [policy + patch] Decide on backwards compatibility policy for Composer plugins in Drupal 8

composer/Plugin/ProjectMessage/Message.php

@@ -6,6 +6,8 @@
 
 /**
  * Determine configuration.
+ *
+ * @internal
  */
 class Message {
 

composer/Plugin/ProjectMessage/MessagePlugin.php

@@ -11,6 +11,8 @@
 
 /**
  * A Composer plugin to display a message after creating a project.
+ *
+ * @internal
  */
 class MessagePlugin implements PluginInterface, EventSubscriberInterface {
 

composer/Plugin/Scaffold/AllowedPackages.php

@@ -12,6 +12,8 @@
  *
  * If the root-level composer.json allows drupal/core, and drupal/core allows
  * drupal/assets, then the later package will also implicitly be allowed.
+ *
+ * @internal
  */
 class AllowedPackages implements PostPackageEventListenerInterface {
 

composer/Plugin/Scaffold/CommandProvider.php

@@ -6,6 +6,8 @@
 
 /**
  * List of all commands provided by this package.
+ *
+ * @internal
  */
 class CommandProvider implements CommandProviderCapability {
 

composer/Plugin/Scaffold/ComposerScaffoldCommand.php

@@ -11,6 +11,8 @@
  *
  * Manually run the scaffold operation that normally happens after
  * 'composer install'.
+ *
+ * @internal
  */
 class ComposerScaffoldCommand extends BaseCommand {
 

composer/Plugin/Scaffold/GenerateAutoloadReferenceFile.php

@@ -8,6 +8,8 @@
 
 /**
  * Generates an 'autoload.php' that includes the autoloader created by Composer.
+ *
+ * @internal
  */
 final class GenerateAutoloadReferenceFile {
 

composer/Plugin/Scaffold/Git.php

@@ -7,6 +7,8 @@
 
 /**
  * Provide some Git utility operations
+ *
+ * @internal
  */
 class Git {
 

composer/Plugin/Scaffold/Handler.php

@@ -17,6 +17,8 @@
  *
  * Contains the primary logic which determines the files to be fetched and
  * processed.
+ *
+ * @internal
  */
 class Handler {
 

composer/Plugin/Scaffold/Interpolator.php

@@ -4,6 +4,8 @@
 
 /**
  * Injects config values from an associative array into a string.
+ *
+ * @internal
  */
 class Interpolator {
 

composer/Plugin/Scaffold/ManageGitIgnore.php

@@ -6,6 +6,8 @@
 
 /**
  * Manage the .gitignore file.
+ *
+ * @internal
  */
 class ManageGitIgnore {
 

composer/Plugin/Scaffold/ManageOptions.php

@@ -12,6 +12,8 @@
  * Projects that describe scaffold files do so via their scaffold options.
  * This data is pulled from the 'drupal-scaffold' portion of the extras
  * section of the project data.
+ *
+ * @internal
  */
 class ManageOptions {
 

composer/Plugin/Scaffold/Operations/AbstractOperation.php

@@ -6,6 +6,8 @@
 
 /**
  * Provides default behaviors for operations.
+ *
+ * @internal
  */
 abstract class AbstractOperation implements OperationInterface {
 

composer/Plugin/Scaffold/Operations/AppendOp.php

@@ -8,6 +8,8 @@
 
 /**
  * Scaffold operation to add to the beginning and/or end of a scaffold file.
+ *
+ * @internal
  */
 class AppendOp extends AbstractOperation {
 

composer/Plugin/Scaffold/Operations/ConjunctionOp.php

@@ -8,6 +8,8 @@
 
 /**
  * Joins two operations on the same file into a single operation.
+ *
+ * @internal
  */
 class ConjunctionOp extends AbstractOperation {
 

composer/Plugin/Scaffold/Operations/OperationData.php

@@ -4,6 +4,8 @@
 
 /**
  * Holds parameter data for operation objects during operation creation only.
+ *
+ * @internal
  */
 class OperationData {
 

composer/Plugin/Scaffold/Operations/OperationFactory.php

@@ -8,6 +8,8 @@
 
 /**
  * Create Scaffold operation objects based on provided metadata.
+ *
+ * @internal
  */
 class OperationFactory {
 

composer/Plugin/Scaffold/Operations/OperationInterface.php

@@ -8,6 +8,8 @@
 
 /**
  * Interface for scaffold operation objects.
+ *
+ * @internal
  */
 interface OperationInterface {
 

composer/Plugin/Scaffold/Operations/ReplaceOp.php

@@ -9,6 +9,8 @@
 
 /**
  * Scaffold operation to copy or symlink from source to destination.
+ *
+ * @internal
  */
 class ReplaceOp extends AbstractOperation {
 

composer/Plugin/Scaffold/Operations/ScaffoldFileCollection.php

@@ -10,6 +10,8 @@
 
 /**
  * Collection of scaffold files.
+ *
+ * @internal
  */
 class ScaffoldFileCollection implements \IteratorAggregate {
 

composer/Plugin/Scaffold/Operations/ScaffoldResult.php

@@ -6,6 +6,8 @@
 
 /**
  * Record the result of a scaffold operation.
+ *
+ * @internal
  */
 class ScaffoldResult {