Adam G-H · Adam G-H
--- a/package_manager/package_manager.api.php 0 → 100644
+++ b/package_manager/package_manager.api.php 0 → 100644
+ *   cannot be created until the current one is destroyed. If subscribers flag
+ *   errors during this event, the stage will release its ownership. This is
+ *   the earliest possible time to detect problems that might prevent the
+ *   stage from completing its life cycle successfully. Only dispatched once
+ *   during a stage's life cycle.
+ *
+ * - \Drupal\package_manager\Event\PostCreateEvent
+ *   Dispatched after the staging area is created, which means that nearly all
+ *   of the running Drupal code base (normally excluding things like public and
+ *   private files, SQLite databases, and other site-specific assets) has been
+ *   copied into a separate, temporary location. Only dispatched once during a
+ *   stage's life cycle.
+ *
+ * - \Drupal\package_manager\Event\PreRequireEvent
+ *   Dispatched before one or more Composer packages are required into the
+ *   staging area. May be dispatched multiple times during a stage's life cycle.
--- a/package_manager/package_manager.api.php 0 → 100644
+++ b/package_manager/package_manager.api.php 0 → 100644
+ *
+ * The public API of any stage consists of at least four methods:
+ *
+ * - \Drupal\package_manager\Stage::create()
+ *   Creates the staging area, records ownership, and dispatches pre- and
+ *   post-create events.
+ *
+ * - \Drupal\package_manager\Stage::require()
+ *   Adds packages to the staging area and dispatches pre- and post-require
+ *   events.
+ *
+ * - \Drupal\package_manager\Stage::apply()
+ *   Copies changes from the staging area into the active directory, and
+ *   dispatches pre- and post-apply events.
+ *
+ * - \Drupal\package_manager\Stage::destroy()