diff --git a/plugin-name/trunk/uninstall.php b/plugin-name/trunk/uninstall.php
index 91336ee..ba70126 100644
--- a/plugin-name/trunk/uninstall.php
+++ b/plugin-name/trunk/uninstall.php
@@ -1,9 +1,20 @@
 <?php
 
 /**
- * Short Description (no period)
+ * Fired when the plugin is uninstalled.
  *
- * Long Description.
+ * When populating this file, consider the following flow
+ * of control:
+ *
+ * - Here, onActivateNewSite() should break. I forgot that the method must be static... facepalm.
+ * - Check if the $_REQUEST content actually is the plugin name.
+ * - Check if it goes through the authentication (admin referrer checks).
+ * - Check the output of $_GET and if it makes sense.
+ * - Repeat with other user roles. Best directly by using the links/query string params.
+ * - Repeat stuff for multisite. Once for a single site in the network, once sitewide.
+ *
+ * For more information, see the following discussion:
+ * https://github.com/tommcfarlin/WordPress-Plugin-Boilerplate/pull/123#issuecomment-28541913
  *
  * @link       http://example.com
  * @since      1.0.0