core/modules/outside_in/outside_in.api.php | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/core/modules/outside_in/outside_in.api.php b/core/modules/outside_in/outside_in.api.php
index 341f9dd..4d4d40d 100644
--- a/core/modules/outside_in/outside_in.api.php
+++ b/core/modules/outside_in/outside_in.api.php
@@ -18,8 +18,18 @@
  * It achieves this by building on the infrastructure that the Contextual
  * Links module provides: Settings Tray provides a "Quick Edit" contextual link
  * for blocks. Clicking this contextual link opens the Settings Tray, which
- * allows to change the contents of the block (not the visibility conditions).
- * This means blocks can be modified without leaving the page.
+ * allows to change the rendered contents of the block by showing all relevant
+ * configuration (minus block visibility conditions). This means blocks can be
+ * modified without leaving the page.
+ *
+ * For example:
+ * - for every block, one can configure whether to display the block title or
+ *   not, and optionally override it (block configuration)
+ * - for menu blocks, one can configure which menu levels to display (block
+ *   configuration) but also the menu itself (menu configuration)
+ * - for the site branding block, one can change which branding elements to
+ *   display (block configuration), but also the site name and slogan (simple
+ *   configuration)
  *
  * The Settings Tray uses a variant of a standard dialog: an off-canvas dialog.
  *