Added more overview

Author: Ian-Read

events/example-with-param.js

@@ -0,0 +1,12 @@
+const { EventEmitter } = require('events')
+
+const foo = function foo(bar) {
+  console.log(`foo has been passed ${bar}`)
+}
+  
+// create an emitter and bind some events to it
+const eventEmitter = new EventEmitter()
+
+eventEmitter.on('foo', foo)
+
+eventEmitter.emit('foo', 'bar')

events/index.md

@@ -3,13 +3,15 @@ layout: default.njk
 title: Events
 ---
 
-Events 
-
 The Node.js core API is built around the idea of events being "emitted" and "listened" to. Objects called "emitters" emit _named_ events, that are picked up by "listener" functions.
 
 Objects that emit events extend the `EventEmitter` class. These objects expose an eventEmitter.on() function that allows one or more functions to be attached to named events emitted by the object.
 
-When the EventEmitter object emits an event, all of the functions attached to that specific event are called synchronously, in the order they were added. This is to prevent race conditions and logic errors. They can switch to an async mode using `setImmediate`.
+When the EventEmitter object emits an event, all of the functions attached to that specific event are called _synchronously_, in the order they were added. This is to prevent race conditions and logic errors. They can switch to an async mode using `setImmediate`.
+
+## A Simple Example
+
+This example creates an event listener for `foo` events, and an event emitter to fire these events.
 
 ```
 const { EventEmitter } = require('events');
@@ -30,5 +32,33 @@ eventEmitter.on('foo', foo)
 eventEmitter.emit('foo')
 ```
 
-Why?
+## Passing parameters
+
+When an event is emitted using the `emit` method, the subsequent arguments are passed through to the listeners. For example:
+
+```
+const foo = function foo(bar) {
+  console.log(`foo has been passed ${bar}`)
+}
+
+// Bind the connection event with the listner1 function
+eventEmitter.on('foo', foo)
+
+// fire the event
+eventEmitter.emit('foo', 'bar')
+```
+
+## Objects:
+
+```
+require('events)
+```
+
+## Methods
+
+`on(eventName, listenerFunction)`
+
+## Summary
+
+Main concept = listeners listen for events, that are emitted from emitters.