docs: expand on seeking by timeline (#414)

Author: eirikbjornr

docs/tutorials/01-playback-strategies.md

@@ -34,7 +34,7 @@ This requires additional config to select which media player implementation to u
 window.bigscreenPlayer.mediaPlayer: 'html5'
 ```
 
-You must also indicate the device's live playback capability. There's more info in [the documentation on live-streaming](https://bbc.github.io/bigscreen-player/api/tutorial-live-streaming.html)
+You must also indicate the device's live playback capability. There's more info in [the documentation on live-streaming](https://bbc.github.io/bigscreen-player/api/tutorial-10-live-streaming.html)
 
 ```javascript
 window.bigscreenPlayer.liveSupport = "seekable"

…s/tutorials/02-settings-and-overrides.md …s/tutorials/01-settings-and-overrides.mddocs/tutorials/02-settings-and-overrides.md renamed to docs/tutorials/01-settings-and-overrides.md docs/tutorials/02-settings-and-overrides.md renamed to docs/tutorials/01-settings-and-overrides.md

@@ -3,6 +3,7 @@ Bigscreen Player uses a variety of events to signal its current state.
 ## Reacting to state changes
 
 State changes which are emitted from the player can be acted upon to by registering a callback. The callback will receive all of the following state changes as the `state` property of the event:
+
 - `MediaState.STOPPED`
 - `MediaState.PAUSED`
 - `MediaState.PLAYING`
@@ -13,17 +14,17 @@ State changes which are emitted from the player can be acted upon to by register
 State changes may be registered for before initialisation and will automatically be cleared upon `tearDown()` of the player.
 
 ```javascript
-var bigscreenPlayer = BigscreenPlayer();
+var bigscreenPlayer = BigscreenPlayer()
 
 // The token is only required in the case where the function is anonymous, a reference to the function can be stored and used to unregister otherwise.
 var stateChangeToken = bigscreenPlayer.registerForStateChanges(function (event) {
-  if(event.state == MediaState.PLAYING) {
-    console.log('Playing');
+  if (event.state == MediaState.PLAYING) {
+    console.log("Playing")
     // handle playing event
   }
-});
+})
 
-bigscreenPlayer.unRegisterForStateChanges(stateChangeToken);
+bigscreenPlayer.unRegisterForStateChanges(stateChangeToken)
 ```
 
 ## Reacting to time updates
@@ -33,14 +34,14 @@ Time updates are emitted multiple times a second. Your application can register
 Time updates may be registered for before initialisation and will automatically be cleared upon `tearDown()` of the player.
 
 ```javascript
-var bigscreenPlayer = BigscreenPlayer();
+var bigscreenPlayer = BigscreenPlayer()
 
 // The token is only required in the case where the function is anonymous, a reference to the function can be stored and used to unregister otherwise.
 var timeUpdateToken = bigscreenPlayer.registerForTimeUpdates(function (event) {
-    console.log('Current Time: ' + event.currentTime);
-});
+  console.log("Current Time: " + event.currentTime)
+})
 
-bigscreenPlayer.unRegisterForTimeUpdates(timeUpdateToken);
+bigscreenPlayer.unRegisterForTimeUpdates(timeUpdateToken)
 ```
 
 ## Reacting to subtitles being turned on/off
@@ -50,12 +51,12 @@ This is emitted on every `setSubtitlesEnabled` call. The emitted object contains
 This may be registered for before initialisation and will automatically be cleared upon `tearDown()` of the player.
 
 ```javascript
-var bigscreenPlayer = BigscreenPlayer();
+var bigscreenPlayer = BigscreenPlayer()
 
 // The token is only required in the case where the function is anonymous, a reference to the function can be stored and used to unregister otherwise.
 var subtitleChangeToken = bigscreenPlayer.registerForSubtitleChanges(function (event) {
-    console.log('Subttiles enabled: ' + event.enabled);
-});
+  console.log("Subttiles enabled: " + event.enabled)
+})
 
-bigscreenPlayer.unregisterForSubtitleChanges(subtitleChangeToken);
-```
+bigscreenPlayer.unregisterForSubtitleChanges(subtitleChangeToken)
+```

docs/tutorials/Debugging.md docs/tutorials/02-debugging.mddocs/tutorials/Debugging.md renamed to docs/tutorials/02-debugging.md

@@ -2,4 +2,4 @@ During playback, `bigscreen-player` may change state (e.g enter buffering, pause
 
 The following diagram describes the flow of these events.
 
-![State Changes](../static/bsp_state_changes_august_2019.png)
+![State Changes](../static/bsp_state_changes_august_2019.png)

docs/tutorials/Events.md docs/tutorials/02-events.mddocs/tutorials/Events.md renamed to docs/tutorials/02-events.md

@@ -1,4 +1,14 @@
-A seek is initiated by `BigscreenPlayer#setCurrentTime()`. It can take a number or a number and a timeline. Each timeline is defined in the `Timeline` enum.
+A seek is initiated by `BigscreenPlayer#setCurrentTime()`.
+
+```js
+bigscreenPlayer.setCurrentTime(30) // seeks in seconds
+```
+
+You can also specify [a timeline (read more in section: Timelines)](#timelines) to anchor your seek:
+
+```js
+bigscreenPlayer.setCurrentTime(Date.now() / 1000 - 60, Timeline.AVAILABILITY_TIME)
+```
 
 BigscreenPlayer will signal a seek is in progress through the `isSeeking` property on the `WAITING` state change.