From a392f3f9db6b36c8ab7c488f4c2e5ffa2a7d6fad Mon Sep 17 00:00:00 2001
From: Tom McFarlin <tom@tommcfarlin.com>
Date: Wed, 30 Apr 2014 22:54:25 -0400
Subject: [PATCH] updating the documentation for the core public plugin file

updating the documentation for the core admin plugin file with docblocks and example functions for how they should be used and their relationship to the public loader
---
 .../trunk/public/class-plugin-name-public.php | 52 ++++++++++++++++---
 1 file changed, 46 insertions(+), 6 deletions(-)

diff --git a/plugin-name/trunk/public/class-plugin-name-public.php b/plugin-name/trunk/public/class-plugin-name-public.php
index a4db2a2..95dc67f 100644
--- a/plugin-name/trunk/public/class-plugin-name-public.php
+++ b/plugin-name/trunk/public/class-plugin-name-public.php
@@ -1,14 +1,54 @@
 <?php
+
 /**
- * @TEAM: http://make.wordpress.org/core/handbook/inline-documentation-standards/php-documentation-standards/#1-functions-and-class-methods
+ * @TODO
+ * Define a short description for what this class does.
  *
- * @package   Plugin_Name
- * @author    Your Name <email@example.com>
- * @license   GPL-2.0+
- * @link      http://example.com
- * @copyright 2014 Your Name or Company Name
+ * @since   x.x.x
+ * @package TODO
  */
 
+/**
+ * @TODO
+ * Define a short description for what this class does.
+ *
+ * Define a longer description for the purpose of this class.
+ *
+ * @package   TODO
+ * @author    Your Name <your@email.com>
+ * @license   GPL-2.0+
+ * @link      URL
+ * @copyright 2014 Your Name of Your Company Name
+ */
 class Plugin_Name_Public {
 
+	/**
+	 * @TODO
+	 * Short description. (use period)
+	 *
+	 * Long description.
+	 *
+	 * @since    1.0.0
+	 * @link     URL
+	 * @param    string    $content    The content for the post type that's being filtered.
+	 * @return   string                The modified version of the post content.
+	 */
+	public function display_the_content( $content ) {
+
+		/**
+		 * This function is provided for demonstration purposes only.
+		 *
+		 * An instance of this class should be passed to the run() function
+		 * defined in Plugin_Name_Public_Loader as all of the hooks are defined
+		 * in that particular class.
+		 *
+		 * The Plugin_Name_Public_Loader will then create the relationship
+		 * between the defined hooks and the functions defined in this
+		 * class.
+		 */
+
+		return $content;
+
+	}
+
 }