diff --git a/README.md b/README.md
index 978ea758949e..20e035cfe057 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,7 @@ Features
 Copyright and license
 =====================
 
-Copyright: (c) 2016-2017 Kong, Inc.
+Copyright: (c) 2016-2018 Kong, Inc.
 
 Author: Thijs Schreijer
 
@@ -35,7 +35,9 @@ use the `rbusted` script.
 History
 =======
 
-### 0.7.x (xx-xxx-201x) Fixes
+Versioning is strictly based on [Semantic Versioning](https://semver.org/)
+
+### 1.0.0 (14-Dec-2017) Fixes and IPv6
 
 - Change: BREAKING all IPv6 addresses are now returned with square brackets
 - Fix: properly recognize IPv6 addresses in square brackets
diff --git a/docs/index.html b/docs/index.html
index b7402dc8d922..8e8bffd93c0f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -74,7 +74,7 @@ <h2>Topics</h2>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
-<i style="float:right;">Last updated 2017-11-27 23:14:29 </i>
+<i style="float:right;">Last updated 2017-12-14 17:33:29 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/resty.dns.balancer.html b/docs/modules/resty.dns.balancer.html
index bb79ecb42dd0..3f26d853c5a5 100644
--- a/docs/modules/resty.dns.balancer.html
+++ b/docs/modules/resty.dns.balancer.html
@@ -78,11 +78,11 @@ <h1>Module <code>resty.dns.balancer</code></h1>
  it will get slots reassigned to it.</p>
 
 <p> <strong>Housekeeping</strong>; the ring-balancer does some house keeping and may insert
- some extra fields in dns records. Those fields will, similar to the <code>toip</code>
- function, have an <code>__</code> prefix (double underscores).</p>
+ some extra fields in dns records. Those fields will have an <code>__</code> prefix
+ (double underscores).</p>
     <h3>Info:</h3>
     <ul>
-        <li><strong>Copyright</strong>: 2016-2017 Kong Inc. All rights reserved.</li>
+        <li><strong>Copyright</strong>: 2016-2018 Kong Inc. All rights reserved.</li>
         <li><strong>License</strong>: Apache 2.0</li>
         <li><strong>Author</strong>: Thijs Schreijer</li>
     </ul>
@@ -457,7 +457,7 @@ <h3>Returns:</h3>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
-<i style="float:right;">Last updated 2017-11-27 23:14:29 </i>
+<i style="float:right;">Last updated 2017-12-14 17:33:29 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/resty.dns.client.html b/docs/modules/resty.dns.client.html
index 10082e52fe5c..1b2646c3c5ff 100644
--- a/docs/modules/resty.dns.client.html
+++ b/docs/modules/resty.dns.client.html
@@ -335,7 +335,7 @@ <h3>Parameters:</h3>
     <h3>Returns:</h3>
     <ol>
 
-        <code>ip address + port + r + try_list</code>, or in case of an error <code>nil + error + r + try_list</code>
+        <code>ip address + port + try_list</code>, or in case of an error <code>nil + error + try_list</code>
     </ol>
 
 
@@ -425,7 +425,7 @@ <h3>Returns:</h3>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
-<i style="float:right;">Last updated 2017-11-27 23:14:29 </i>
+<i style="float:right;">Last updated 2017-12-14 17:33:29 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/resty.dns.utils.html b/docs/modules/resty.dns.utils.html
index 6a56ff680879..30711a944d79 100644
--- a/docs/modules/resty.dns.utils.html
+++ b/docs/modules/resty.dns.utils.html
@@ -64,7 +64,7 @@ <h1>Module <code>resty.dns.utils</code></h1>
 <p> <em>NOTE</em>: parsing the files is done using blocking i/o file operations.</p>
     <h3>Info:</h3>
     <ul>
-        <li><strong>Copyright</strong>: 2016-2017 Kong Inc.</li>
+        <li><strong>Copyright</strong>: 2016-2018 Kong Inc.</li>
         <li><strong>License</strong>: Apache 2.0</li>
         <li><strong>Author</strong>: Thijs Schreijer</li>
     </ul>
@@ -453,7 +453,8 @@ <h3>Usage:</h3>
     </dt>
     <dd>
     parses a hostname with an optional port.
- Does not validate the name/ip.
+ Does not validate the name/ip. IPv6 addresses are always returned in
+ square brackets, even if the input wasn't.
 
 
     <h3>Parameters:</h3>
@@ -480,7 +481,7 @@ <h3>Returns:</h3>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
-<i style="float:right;">Last updated 2017-11-27 23:14:29 </i>
+<i style="float:right;">Last updated 2017-12-14 17:33:29 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/readme.md.html b/docs/topics/readme.md.html
index 59273eb21134..54e7db0da8db 100644
--- a/docs/topics/readme.md.html
+++ b/docs/topics/readme.md.html
@@ -69,7 +69,7 @@ <h1>Features</h1>
 
 <h1>Copyright and license</h1>
 
-<p>Copyright: (c) 2016-2017 Kong, Inc.</p>
+<p>Copyright: (c) 2016-2018 Kong, Inc.</p>
 
 <p>Author: Thijs Schreijer</p>
 
@@ -82,6 +82,15 @@ <h1>Testing</h1>
 
 <h1>History</h1>
 
+<p>Versioning is strictly based on <a href="https://semver.org/">Semantic Versioning</a></p>
+
+<h3>1.0.0 (14-Dec-2017) Fixes and IPv6</h3>
+
+<ul>
+    <li>Change: BREAKING all IPv6 addresses are now returned with square brackets</li>
+    <li>Fix: properly recognize IPv6 addresses in square brackets</li>
+</ul>
+
 <h3>0.6.3 (27-Nov-2017) Fixes and flagging unhealthy peers</h3>
 
 <ul>
@@ -215,7 +224,7 @@ <h3>0.1 (09-Sep-2016) Initial released version</h3>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
-<i style="float:right;">Last updated 2017-11-27 23:14:29 </i>
+<i style="float:right;">Last updated 2017-12-14 17:33:29 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/lua-resty-dns-client-0.6.3-1.rockspec b/lua-resty-dns-client-1.0.0-1.rockspec
similarity index 82%
rename from lua-resty-dns-client-0.6.3-1.rockspec
rename to lua-resty-dns-client-1.0.0-1.rockspec
index 0e2a7000a605..a4a327fa3c66 100644
--- a/lua-resty-dns-client-0.6.3-1.rockspec
+++ b/lua-resty-dns-client-1.0.0-1.rockspec
@@ -1,8 +1,8 @@
 package = "lua-resty-dns-client"
-version = "0.6.3-1"
+version = "1.0.0-1"
 source = {
-  url = "https://github.com/Kong/lua-resty-dns-client/archive/0.6.3.tar.gz",
-  dir = "lua-resty-dns-client-0.6.3"
+  url = "https://github.com/Kong/lua-resty-dns-client/archive/1.0.0.tar.gz",
+  dir = "lua-resty-dns-client-1.0.0"
 }
 description = {
   summary = "DNS library",
diff --git a/src/resty/dns/balancer.lua b/src/resty/dns/balancer.lua
index d3901b206d2c..c0ec5845cc6f 100644
--- a/src/resty/dns/balancer.lua
+++ b/src/resty/dns/balancer.lua
@@ -30,7 +30,7 @@
 -- (double underscores).
 --
 -- @author Thijs Schreijer
--- @copyright 2016-2017 Kong Inc. All rights reserved.
+-- @copyright 2016-2018 Kong Inc. All rights reserved.
 -- @license Apache 2.0
 
 
diff --git a/src/resty/dns/utils.lua b/src/resty/dns/utils.lua
index 621991df6462..b78358274eb9 100644
--- a/src/resty/dns/utils.lua
+++ b/src/resty/dns/utils.lua
@@ -6,7 +6,7 @@
 --
 -- _NOTE_: parsing the files is done using blocking i/o file operations.
 --
--- @copyright 2016-2017 Kong Inc.
+-- @copyright 2016-2018 Kong Inc.
 -- @author Thijs Schreijer
 -- @license Apache 2.0