diff --git a/eth-simple-shortlinks.php b/eth-simple-shortlinks.php
index 0688ec51f9193cfff1d2fb442788a82765160f0e..a67b05c9d904b335aa9694bed9cb7f96b545d292 100644
--- a/eth-simple-shortlinks.php
+++ b/eth-simple-shortlinks.php
@@ -151,6 +151,10 @@ class ETH_Simple_Shortlinks {
 		}
 	}
 
+	/**
+	 * PLUGIN FUNCTIONALITY
+	 */
+
 	/**
 	 * Allow filtering of supported statuses and types
 	 */
@@ -276,6 +280,9 @@ class ETH_Simple_Shortlinks {
 	}
 }
 
+/**
+ * One instance to rule them all
+ */
 ETH_Simple_Shortlinks::get_instance();
 
 /**
diff --git a/readme.txt b/readme.txt
index 6f081598fcc878411253e0fd78e9eb7a01bdb44e..5cf895aaa034781d665cb25bcc39e6b27b0046cd 100644
--- a/readme.txt
+++ b/readme.txt
@@ -4,7 +4,7 @@ Donate link: https://ethitter.com/donate/
 Tags: seo, meta tags
 Requires at least: 4.4
 Tested up to: 4.5
-Stable tag: 0.4
+Stable tag: 0.5
 License: GPLv2 or later
 License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
@@ -32,5 +32,10 @@ No, shortlinks use the posts' IDs, so aren't available for modification.
 
 == Changelog ==
 
+= 0.5 =
+* Admin notices when permalinks won't support the plugin
+* Disable plugin functionality when permalink structure is incompatible
+* Translation support
+
 = 0.4 =
 * Initial release
\ No newline at end of file