diff --git a/docs/guides/hooks.md b/docs/guides/hooks.md index f53ecb63b2..23ce9f9b20 100644 --- a/docs/guides/hooks.md +++ b/docs/guides/hooks.md @@ -1,6 +1,6 @@ # Hooks -Hooks exist so that users can "hook" on to certain Video.js player lifecycle +Hooks exist so that users can globally hook into certain Video.js lifecycle moments. ## Table of Contents @@ -18,129 +18,153 @@ Currently, the following hooks are available: ### beforesetup -`beforesetup` is called just before the player is created. This allows: +`beforesetup` occurs just before a player is created. This allows: -* modification of the options passed to the Video.js function (`videojs('some-id, options)`) -* modification of the dom video element that will be used for the player +* Modification of the options passed to the Video.js function (e.g., `videojs('some-id, options)`). +* Modification of the DOM video element that will be used for the player that will be created. `beforesetup` hook functions should: -* take two arguments - 1. videoEl: dom video element that Video.js is going to use to create a player - 1. options: options that Video.js was intialized with and will later pass to the player during creation -* return options that will merge and override options that Video.js with intialized with +* Take two arguments: + 1. `videoEl`: DOM `