Updated Core API (markdown)

Core-API.md

@@ -116,4 +116,24 @@ These properties are inside of the WebSlides instance and they could be useful t
 - `options`: An object with all the options given to the constructor (as seen above).
 - `initialised`: A Boolean indicating whether WebSlides has finished the initialisation or not.
 
+### Events
+
+WebSlides fires events on the WebSlide's element. 
+
+#### `ws:init`
+
+Called once WebSlides has been initialised and the `initialised` flag is set to `true`. This happens _after_ all plugins have been created and all Slides have been parsed (in that order).
+
+#### `ws:slide-change`
+
+Called once the slide **has finished** transitioning into view. The `event.detail` contains the following information:
+
+```javascript
+{
+  slides: Number, // Number of slides on WebSlides (this wont change)
+  currentSlide0: Number, // Current slide index (0 based)
+  currentSlide: Number // Current slide index
+}
+```
+
 ## `Slide` class