adding simple public-facing code comments

plugin-name/trunk/public/js/plugin-name-public.js

@@ -1,4 +1,28 @@
 (function( $ ) {
 	'use strict';
 
+	/**
+	 * @TODO
+	 *
+	 * All of the code for your public-facing JavaScript source
+	 * should reside in this file.
+	 *
+	 * Note that this assume you're going to user jQuery, so it prepares
+	 * the $ function reference to be used within the scope of this
+	 * function.
+	 *
+	 * From here, you're able to define handlers for when the DOM is
+	 * ready:
+	 *
+	 * $(function() {
+	 * });
+	 *
+	 * Or when the window is completely ready:
+	 *
+	 * $( window ).load(function() {
+	 * });
+	 *
+	 * ...and so on.
+	 */
+
 })( jQuery );