Updating doc block

* class-plugin-name now includes different file and class documentation
* changing a URL to an example URL

plugin-name/trunk/includes/class-plugin-name.php

@@ -1,13 +1,10 @@
 <?php
 
 /**
- * The core plugin class
+ * The file that defines the core plugin class
  *
- * This is used to define internationalization, dashboard-specific hooks, and
- * public-facing site hooks.
- *
- * Also maintains the unique identifier of this plugin as well as the current
- * version of the plugin.
+ * A class definition that includes attributes and functions used across both the
+ * public-facing side of the site and the dashboard.
  *
  * @link       http://example.com
  * @since      1.0.0

plugin-name/trunk/plugin-name.php

@@ -8,7 +8,7 @@
  * registers the activation and deactivation functions, and defines a function
  * this starts the plugin.
  *
- * @link              URL
+ * @link              http://example.com
  * @since             1.0.0
  * @package           Plugin_Name
  *