tweaks and comments

js/components/playback.js

@@ -1,15 +1,16 @@
 /**
- * UI component that lets the user control pause/resume
- * and see the progress of auto-slide playback.
- *
- * @param {HTMLElement} container The component will append
- * itself to this
- * @param {function} progressCheck A method which will be
- * called frequently to get the current progress on a range
- * of 0-1
+ * UI component that lets the use control auto-slide
+ * playback via play/pause.
  */
 export default class Playback {
 
+	/**
+	 * @param {HTMLElement} container The component will append
+	 * itself to this
+	 * @param {function} progressCheck A method which will be
+	 * called frequently to get the current playback progress on
+	 * a range of 0-1
+	 */
 	constructor( container, progressCheck ) {
 
 		// Cosmetics

js/reveal.js

@@ -2494,7 +2494,7 @@ export default function( revealElement, options ) {
 		loadSlide: slideContent.load.bind( slideContent ),
 		unloadSlide: slideContent.unload.bind( slideContent ),
 
-		// Adds or removes all internal event listeners (such as keyboard)
+		// Adds or removes all internal event listeners
 		addEventListeners,
 		removeEventListeners,
 		dispatchEvent,
@@ -2515,8 +2515,8 @@ export default function( revealElement, options ) {
 		// Returns an Array of all slides
 		getSlides,
 
-		// Returns an Array of objects representing the attributes on
-		// the slides
+		// Returns an Array of key:value maps of the attributes of each
+		// slide in the deck
 		getSlidesAttributes,
 
 		// Returns the total number of slides