Add property and event documentation

Create some high-level descriptions of the properties and events the plugin exports.

@@ -46,11 +46,51 @@ support for:
 
 
 - Alternate audio and video tracks
 - Alternate audio and video tracks
 - Subtitles
 - Subtitles
-- Dynamic bitrate switching
 - Segment codecs _other than_ H.264 with AAC audio
 - Segment codecs _other than_ H.264 with AAC audio
 - Live streams
 - Live streams
 - Internet Explorer 8
 - Internet Explorer 8
 
 
+### Runtime Properties
+#### player.hls.master
+Type: `object`
+
+An object representing the parsed master playlist. If a media playlist
+is loaded directly, a master playlist with only one entry will be
+created.
+
+#### player.hls.media
+Type: `object`
+
+An object representing the currently selected media playlist. This is
+the playlist that is being referred to when a additional video data
+needs to be downloaded.
+
+#### player.hls.mediaIndex
+Type: `number`
+
+The index of the next video segment to be downloaded from
+`player.hls.media`.
+
+#### player.hls.selectPlaylist
+Type: `function`
+
+A function that returns the media playlist object to use to download
+the next segment. It is invoked by the plugin immediately before a new
+segment is downloaded. You can override this function to provide your
+adaptive streaming logic. You must, however, be sure to return a valid
+media playlist object that is present in `player.hls.master`.
+
+### Events
+#### loadedmetadata
+
+Fired after the first media playlist is downloaded for a stream.
+
+#### loadedmanifest
+
+Fired immediately after a new master or media playlist has been
+downloaded. By default, the plugin only downloads playlists as they
+are needed.
+
 ## Hosting Considerations
 ## Hosting Considerations
 Unlike a native HLS implementation, the HLS plugin has to comply with
 Unlike a native HLS implementation, the HLS plugin has to comply with
 the browser's security policies. That means that all the files that
 the browser's security policies. That means that all the files that