From af5c13f5150512ee6714250647e6c8c3cc4a7d5e Mon Sep 17 00:00:00 2001
From: alexweissman <alex@alexanderweissman.com>
Date: Fri, 8 Sep 2017 14:27:18 -0400
Subject: [PATCH] events docs

---
 .../12.programmatic-control/02.events/docs.md |  6 +++-
 pages/14.advanced/events.html                 | 28 -------------------
 2 files changed, 5 insertions(+), 29 deletions(-)
 delete mode 100644 pages/14.advanced/events.html

diff --git a/pages/12.programmatic-control/02.events/docs.md b/pages/12.programmatic-control/02.events/docs.md
index fff8564e..6132c87a 100644
--- a/pages/12.programmatic-control/02.events/docs.md
+++ b/pages/12.programmatic-control/02.events/docs.md
@@ -23,6 +23,8 @@ Select2 will trigger a few different events when different actions are taken usi
 
 ## Listening for events
 
+All public events are relayed using the jQuery event system, and they are triggered on the `<select>` element that Select2 is attached to. You can attach to them using the [`.on` method](https://api.jquery.com/on/) provided by jQuery:
+
 ```
 $('select').on('select2:select', function (e) {
   // Do something
@@ -94,4 +96,6 @@ function log (name, evt) {
 
 ## Internal Select2 events
 
-Select2 has an [internal event system](/advanced/default-adapters/selection#eventrelay) that works independently of the DOM event system. This internal event system is only accessible from plugins and adapters that are connected to Select2.
+Select2 has an [internal event system](/advanced/default-adapters/selection#eventrelay) that works independently of the DOM event system, allowing adapters to communicate with each other. This internal event system is only accessible from plugins and adapters that are connected to Select2 - **not** through the jQuery event system.
+
+You can find more information on the public events triggered by individual adapters in the [advanced chapter](/advanced).
diff --git a/pages/14.advanced/events.html b/pages/14.advanced/events.html
deleted file mode 100644
index eeb9707d..00000000
--- a/pages/14.advanced/events.html
+++ /dev/null
@@ -1,28 +0,0 @@
-
-  <h2 id="events-public">
-    Public events
-  </h2>
-
-  <p>
-    All public events are relayed using the jQuery event system, and they are
-    triggered on the <code>&lt;select&gt;</code> element that Select2 is
-    attached to. You can attach to them using the
-    <a href="https://api.jquery.com/on/"><code>.on</code> method</a> provided
-    by jQuery.
-  </p>
-
-  <h2 id="events-internal">
-    Internal events
-  </h2>
-
-  <p>
-    Select2 triggers internal events using its own internal event system,
-    which allows adapters to communicate with each other. These events are not
-    accessible through the jQuery event system.
-  </p>
-
-  <p>
-    You can find more information on the public events triggered by individual
-    adapters in <a href="#adapters">the individual adapter documentation</a>.
-  </p>
-</section>