From 94dcc8905324ea02ff3b80b94efe2394cd433a8b Mon Sep 17 00:00:00 2001
From: haad <haad@headbanggames.com>
Date: Tue, 28 Nov 2017 13:22:44 +0100
Subject: [PATCH] Add CHANGELOG for 0.18.0 release

---
 CHANGELOG.md | 49 +++++++++++++++++++++++++++++++++++++++++--------
 README.md    |  2 ++
 2 files changed, 43 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8d1b3f7..0261435 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,13 +1,46 @@
 # Changelog
 
-## v2.0.0
-- addresses
-- write-permissions
-- replication
-- performance
-- use ipfs, no more ipfs-daemon
-- async/await
-- logging
+## v0.18.0
+
+This release is a major one as we've added new features, fixed many of the old problems, improved the performance and code base and overhauled the documentation. OrbitDB is now more robust, easier to use, faster and comes with much awaited write-permissions feature.
+
+***This release contains API breaking changes with no backward compatibility!*** Read further and see the [API documentation](https://github.com/orbitdb/orbit-db/blob/master/API.md), [examples](https://github.com/orbitdb/orbit-db/tree/master/examples) and [Getting Started Guide](https://github.com/orbitdb/orbit-db/blob/master/GUIDE.md) to learn more about the changes. Note that we don't use semver for the npm module, so be sure to lock your orbit-db dependency to the previous release if you don't want to upgrade.
+
+### Write-permissions
+
+OrbitDB now has write-permissioned databases! \o/ This gives us verifiable, distributed databases and data structures enabling tons of new use cases and possibilities. User-owned data collections, feeds and lists, State and Payment Channels, and many more! 
+
+Permissions are defined by public keys and databases in OrbitDB support one or multiple write keys per database. Each database update is signed with a write-access key and the signature is verified by the clients against access control information. Next step is to extend the access control functionality to include read permissions. Read more about [Access Control](https://github.com/orbitdb/orbit-db/blob/master/GUIDE.md#access-control) and [Keys](https://github.com/orbitdb/orbit-db/blob/master/GUIDE.md#keys).
+
+### Addresses
+
+OrbitDB databases, their name and ID, are now addressed through a naming scheme:
+
+```
+/orbitdb/Qmd8TmZrWASypEp4Er9tgWP4kCNQnW4ncSnvjvyHQ3EVSU/my/database/hello
+```
+
+Read more about [Addresses](https://github.com/orbitdb/orbit-db/blob/master/GUIDE.md#address).
+
+### Replication
+
+The previous versions of OrbitDB had a flaky replication implementation which has been completely re-written for this release. We've made performance improvements and more importantly, peers now start syncing the database automatically and reliably.
+
+### Performance
+
+Several performance improvements made throughout OrbitDB's code base together with latest [IPFS](https://github.com/ipfs/js-ipfs) we're seeing much better throughput numbers in benchmarks. There are still many improvements to be made!
+
+### Documentation and Examples
+
+We've written a brand new [Getting Started Guide](https://github.com/orbitdb/orbit-db/blob/master/GUIDE.md) to work as a tutorial and a place to understand OrbitDB's features and usage. The [API documentation](https://github.com/orbitdb/orbit-db/blob/master/API.md) was also updated to reflect latest features and changes.
+
+All [examples](https://github.com/orbitdb/orbit-db/tree/master/examples) were updated along with an [updated UI](https://raw.githubusercontent.com/orbitdb/orbit-db/feat/write-access/screenshots/example1.png) for the [browser demo](https://ipfs.io/ipfs/QmRosp97r8GGUEdj5Wvivrn5nBkuyajhRXFUcWCp5Zubbo/). [Another small browser demo](https://ipfs.io/ipfs/QmasHFRj6unJ3nSmtPn97tWDaQWEZw3W9Eh3gUgZktuZDZ/) was added and there's a [TodoMVC with Orbitdb example](https://github.com/orbitdb/orbit-db/issues/246) in the works.
+
+### Code Base Improvements
+
+Due to legacy reasons, OrbitDB previously used a wrapper module for IPFS called `ipfs-daemon`. We have removed and deprecated `ipfs-daemon` and are now using [js-ipfs](https://github.com/ipfs/js-ipfs) directly!
+
+We've switched to using *async/await* in the code base throughout the modules. This means the minimum required version of Node.js is now 8.0.0. To use with older versions of Node.js, we provide an [ES5-compatible build](https://github.com/orbitdb/orbit-db/tree/master/dist/es5). We've also added support for logging, which can be turned on with `LOG=[debug|warn|error]` environment variable.
 
 ## v0.12.0
 - IPFS pubsub
diff --git a/README.md b/README.md
index 725b4f7..d5d6f30 100644
--- a/README.md
+++ b/README.md
@@ -152,6 +152,8 @@ npm run build
 node benchmarks/benchmark-add.js
 ```
 
+See [benchmarks/]() for more benchmarks.
+
 #### Logging
 
 To enable OrbitDB's logging output, set a global ENV variable called `LOG` to `debug`,`warn` or `error`: