Merge branch 'main' into plugin-author

Author: timmywil

order.json

@@ -76,8 +76,7 @@
       "finding-evaluating-plugins",
       "basic-plugin-creation",
       "publishing-plugins",
-      "advanced-plugin-concepts",
-      "stateful-plugins-with-widget-factory"
+      "advanced-plugin-concepts"
     ]
   },
   {

page/events/introduction-to-custom-events.md

@@ -19,10 +19,10 @@ Why should you care? An example is probably the best way to explain. Suppose you
 
 ```
 <div class="room" id="kitchen">
-	<div class="lightbulb on"></div>
-	<div class="switch"></div>
-	<div class="switch"></div>
-	<div class="clapper"></div>
+	<div class="lightbulb on">Kitchen light</div>
+	<div class="switch">Kitchen switch 1</div>
+	<div class="switch">Kitchen switch 2</div>
+	<div class="clapper">Kitchen clapper switch</div>
 </div>
 ```
 
@@ -65,18 +65,18 @@ Let's make our example a little more interesting. We'll add another room to our
 
 ```
 <div class="room" id="kitchen">
-	<div class="lightbulb on"></div>
-	<div class="switch"></div>
-	<div class="switch"></div>
-	<div class="clapper"></div>
+	<div class="lightbulb on">Kitchen light</div>
+	<div class="switch">Kitchen switch 1</div>
+	<div class="switch">Kitchen switch 2</div>
+	<div class="clapper">Kitchen clapper switch</div>
 </div>
 <div class="room" id="bedroom">
-	<div class="lightbulb on"></div>
-	<div class="switch"></div>
-	<div class="switch"></div>
-	<div class="clapper"></div>
+	<div class="lightbulb on">Bedroom light</div>
+	<div class="switch">Bedroom switch 1</div>
+	<div class="switch">Bedroom switch 2</div>
+	<div class="clapper">Bedroom clapper switch</div>
 </div>
-<div id="master_switch"></div>
+<div id="master_switch">Master switch</div>
 ```
 
 If there are any lights on in the house, we want the master switch to turn all the lights off; otherwise, we want it to turn all lights on. To accomplish this, we'll add two more custom events to the lightbulbs: `light:on` and `light:off`. We'll make use of them in the `light:toggle` custom event, and use some logic to decide which one the master switch should trigger:

page/plugins.md

@@ -14,3 +14,9 @@ A jQuery plugin is simply a new method that we use to extend jQuery's prototype
 The idea of a plugin is to do something with a collection of elements. You could consider each method that comes with the jQuery core a plugin, like `.fadeOut()` or `.addClass()`.
 
 You can make your own plugins and use them privately in your code or you can release them into the wild. There are thousands of jQuery plugins available online. The barrier to creating a plugin of your own is so low that you'll want to do it straight away!
+
+While most existing jQuery plugins are stateless – that is, we call them on an element and that is the extent of our interaction with the plugin – there's a large set of functionality that doesn't fit into the basic plugin pattern.
+
+In order to fill this gap, jQuery UI has implemented a more advanced plugin system. The new system manages state, allows multiple functions to be exposed via a single plugin, and provides various extension points. This system is called the Widget Factory and is exposed as `jQuery.widget` as part of jQuery UI 1.8; however, it can be used independently of jQuery UI.
+
+For details on the capabilities of the Widget Factory, see this [How To Use the Widget Factory](/jquery-ui/widget-factory/how-to-use-the-widget-factory/).