diff --git a/readme.md b/readme.md
index ce28365..15c4fa8 100644
--- a/readme.md
+++ b/readme.md
@@ -360,10 +360,21 @@ We use a hook because if you attempt to dequeue a script before it's enqueued, w
 
 ## Version
 
-3.0.0
+3.1.0
 
 ## Changelog
 
+**3.1.0**
+
+- Adds special handling of GIFs in srcset attributes to preserve animation (issue #223).
+- Makes internal srcset/sizes functions more consistent (issue #224).
+- Fixes a bug where functions hooked into `tevkori_image_sizes_args` were not firing (issue #226).
+- Fixes a bug where custom sizes attributes added via the post editor were being overwritten (issue #227).
+- Deprecates hook `wp_get_attachment_image_sizes` (issue #228).
+- Fixes a bug where `the_post_thumbnail()` would fail to add srcset/sizes attributes (issue #232).
+- Several improvements to internal inline documentation.
+- Major improvements to function/hook documentation in readme.md after 3.0.0 changes.
+
 **3.0.0**
 
 - Deprecates all core functions that will be merged into WordPress core in 4.4.
diff --git a/readme.txt b/readme.txt
index 2211bcb..ae98f85 100644
--- a/readme.txt
+++ b/readme.txt
@@ -4,7 +4,7 @@ Donate link: https://app.etapestry.com/hosted/BoweryResidentsCommittee/OnlineDon
 Tags: Responsive, Images, Responsive Images, SRCSET, Picturefill
 Requires at least: 4.0
 Tested up to: 4.3
-Stable tag: 3.0.0
+Stable tag: 3.1.0
 License: GPLv2
 License URI: http://www.gnu.org/licenses/gpl-2.0.txt
 
@@ -16,8 +16,11 @@ Bringing automatic default responsive images to WordPress.
 
 This plugin works by including all available image sizes for each image upload. Whenever WordPress outputs the image through the media uploader, or whenever a featured image is generated, those sizes will be included in the image tag via the srcset attribute.
 
-**Notice**
-As of version 2.5.0, the plugin adds `srcset` and `sizes` attributes to images on the front end instead of adding them to the image markup saved in posts.
+**Important notes**
+
+* Version 3.1.0 includes important changes that make this plugin compatible with WordPress version 4.4. Upgrading is highly recommended.
+
+* As of version 2.5.0, the plugin adds `srcset` and `sizes` attributes to images on the front end instead of adding them to the image markup saved in posts.
 
 **Full documentation and contributor guidelines can be found on [Github](https://github.com/ResponsiveImagesCG/wp-tevko-responsive-images)**
 
@@ -29,6 +32,16 @@ As of version 2.5.0, the plugin adds `srcset` and `sizes` attributes to images o
 
 == Changelog ==
 
+= 3.1.0 =
+* Adds special handling of GIFs in srcset attributes to preserve animation.
+* Makes internal srcset/sizes functions more consistent.
+* Fixes a bug where functions hooked into `tevkori_image_sizes_args` were not firing.
+* Fixes a bug where custom sizes attributes added via the post editor were being overwritten.
+* Deprecates hook `wp_get_attachment_image_sizes`.
+* Fixes a bug where `the_post_thumbnail()` would fail to add srcset/sizes attributes.
+* Several improvements to internal inline documentation.
+* Major improvements to function/hook documentation in readme.md after 3.0.0 changes.
+
 = 3.0.0 =
 * Deprecates all core functions that will be merged into WordPress core in 4.4.
 * Adds compatibility shims for sites using the plugin's internal functions and hooks.