diff --git a/README.md b/README.md
index 7f5af6a88..28dea11de 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ Join gridstack.js on Slack: https://gridstackjs.troolee.com
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 **Table of Contents**  *generated with [DocToc](http://doctoc.herokuapp.com/)*
 
-- [gridstack.js News](#gridstackjs-news)
+<!--- [gridstack.js News](#gridstackjs-news) -->
 - [Demo and examples](#demo-and-examples)
 - [Usage](#usage)
   - [Requirements](#requirements)
@@ -36,7 +36,7 @@ Join gridstack.js on Slack: https://gridstackjs.troolee.com
 - [Changes](#changes)
 - [The Team](#the-team)
 
-<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+<!-- END doctoc generated TOC please keep comment here to allow auto update 
 
 
 gridstack.js News
@@ -44,7 +44,7 @@ gridstack.js News
 
 Version 1.0 is coming! Check out the blog post here for more information:
 [https://dylandreams.com/2017/04/26/gridstack-10-coming-soon/](https://dylandreams.com/2017/04/26/gridstack-10-coming-soon/) and [subscribe to the blog](https://dylandreams.com) for more gridstack news and tutorials.
-
+-->
 
 Demo and examples
 ====
@@ -78,9 +78,9 @@ Usage
 * Using CDN:
 
 ```html
-<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.4.0/gridstack.min.css" />
-<script type="text/javascript" src='//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.4.0/gridstack.min.js'></script>
-<script type="text/javascript" src='//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.4.0/gridstack.jQueryUI.min.js'></script>
+<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.5.0/gridstack.min.css" />
+<script type="text/javascript" src='//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.5.0/gridstack.min.js'></script>
+<script type="text/javascript" src='//cdnjs.cloudflare.com/ajax/libs/gridstack.js/0.5.0/gridstack.jQueryUI.min.js'></script>
 ```
 
 * Using bower:
@@ -97,7 +97,7 @@ $ bower install gridstack
 $ npm install gridstack
 ```
 
-You can download files from `dist` directory as well.
+You can download source and build and use `dist` directory as well for latest non published code.
 
 ## Basic usage
 
@@ -309,11 +309,13 @@ for i in range(N):
 There are at least two more issues with gridstack in IE8 with jQueryUI resizable (it seems it doesn't work) and
 droppable. If you have any suggestions about support of IE8 you are welcome here: https://github.com/gridstack/gridstack.js/issues/76
 
+<!-- fixed in 0.5.0 with #643 ?
 ## Use with require.js
 
 If you're using require.js and a single file jQueryUI please check out this
 [Stackoverflow question](http://stackoverflow.com/questions/35582945/redundant-dependencies-with-requirejs) to get it
 working properly.
+-->
 
 Changes
 =====
diff --git a/bower.json b/bower.json
index b400ead99..1a074a74f 100644
--- a/bower.json
+++ b/bower.json
@@ -1,6 +1,6 @@
 {
   "name": "gridstack",
-  "version": "1.0.0-dev",
+  "version": "0.5.0",
   "homepage": "https://github.com/gridstack/gridstack.js",
   "authors": [
     "Pavel Reznikov <pashka.reznikov@gmail.com>",
diff --git a/doc/CHANGES.md b/doc/CHANGES.md
index bebbe2970..f56adc370 100644
--- a/doc/CHANGES.md
+++ b/doc/CHANGES.md
@@ -6,6 +6,7 @@ Change log
 **Table of Contents**  *generated with [DocToc](http://doctoc.herokuapp.com/)*
 
 - [v1.0.0 (development)](#v100-development)
+- [v0.5.0 (2019-03-29)](#v050-2019-03-29)
 - [v0.4.0 (2018-05-11)](#v040-2018-05-11)
 - [v0.3.0 (2017-04-21)](#v030-2017-04-21)
 - [v0.2.6 (2016-08-17)](#v026-2016-08-17)
@@ -21,10 +22,19 @@ Change log
 
 ## v1.0.0 (development)
 
+TBD
+
+## v0.5.0 (2019-03-29)
+
 - emit `dropped` event when a widget is dropped from one grid into another ([#823](https://github.com/gridstack/gridstack.js/issues/823)).
 - don't throw error if no bounding scroll element is found ([#891](https://github.com/gridstack/gridstack.js/issues/891)).
 - don't push locked widgets even if they are at the top of the grid ([#882](https://github.com/gridstack/gridstack.js/issues/882)).
+- RequireJS and CommonJS now export on the `exports` module fix ([#643](https://github.com/gridstack/gridstack.js/issues/643)).
+- automatically scroll page when widget is moving beyond viewport ([#827](https://github.com/gridstack/gridstack.js/issues/827)).
 - removed lodash dependencies ([#693](https://github.com/gridstack/gridstack.js/issues/693)).
+- don't overwrite globals jQuery when in a modular environment ([#974](https://github.com/gridstack/gridstack.js/pull/974)).
+- removed z-index from `.grid-stack-item-content` causing child modal dialog clipping ([#984](https://github.com/gridstack/gridstack.js/pull/984)).
+- convert project to use yarn ([#983](https://github.com/gridstack/gridstack.js/pull/983)).
 
 ## v0.4.0 (2018-05-11)
 
diff --git a/package.json b/package.json
index 55bf8c989..c14b4de1c 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "gridstack",
-  "version": "1.0.0-dev",
+  "version": "0.5.0",
   "description": "gridstack.js is a jQuery plugin for widget layout",
   "main": "dist/gridstack.js",
   "repository": {
diff --git a/src/gridstack.jQueryUI.js b/src/gridstack.jQueryUI.js
index 1cc01ccbc..25b25f996 100644
--- a/src/gridstack.jQueryUI.js
+++ b/src/gridstack.jQueryUI.js
@@ -1,5 +1,5 @@
 /**
- * gridstack.js 1.0.0-dev
+ * gridstack.js 0.5.0
  * http://troolee.github.io/gridstack.js/
  * (c) 2014-2017 Pavel Reznikov, Dylan Weiss
  * gridstack.js may be freely distributed under the MIT license.
diff --git a/src/gridstack.js b/src/gridstack.js
index 32b834045..9500e59f6 100644
--- a/src/gridstack.js
+++ b/src/gridstack.js
@@ -1,5 +1,5 @@
 /**
- * gridstack.js 1.0.0-dev
+ * gridstack.js 0.5.0
  * http://troolee.github.io/gridstack.js/
  * (c) 2014-2018 Pavel Reznikov, Dylan Weiss
  * gridstack.js may be freely distributed under the MIT license.