CHANGELOG and CONTRIBUTING updates

Author: bcomnes

CHANGELOG.md

@@ -0,0 +1,10 @@
+# netlify Change Log
+All notable changes to this project will be documented in this file.
+This project adheres to [Semantic Versioning](http://semver.org/).
+
+## 2.0.1 - 2018-09-25
+* A whole new Netlify Node.js API client! 🎉
+* Client code was extracted from our forthcoming [2.0.0 CLI](https://www.netlify.com/blog/2018/09/10/netlify-cli-2.0-now-in-beta-/) release.
+* A completely new API.  Treat the 2.x.x and forward as a completely separate codebase and API.
+* API calls are now derived from the [open-api](https://github.com/netlify/open-api) specification.  See the [swagger-ui](https://open-api.netlify.com/#/default) and know that there is a matching API method for every operationID (the name on the right).  See the README for full API docs.
+* Includes a method for creating content based deploys.

CONTRIBUTING.md

@@ -5,29 +5,51 @@ please read the [code of conduct](CODE_OF_CONDUCT.md).
 
 ## Setup
 
-> Install NPM on your system: https://docs.npmjs.com/getting-started/installing-node
+> Install Node.js + npm on your system: https://nodejs.org/en/download/
 
 ```sh
 $ git clone https://github.com/netlify/js-client netlify-js-client
 $ cd netlify-js-client
 $ npm install
+$ npm test
 ```
 
+You can also use yarn.
+
 ## Testing
 
-```sh
-$ jasmine-node spec
-```
+This repo uses [ava](https://github.com/avajs/ava) for testing.  
+Any files in the `src` directory that have a `.test.js` file extension are automatically detected and run as tests.
+
+We also test for a few other variables:
+
+- Dependencies (used an unused)
+- Linting
+- Coverage
+- Must work with Windows + Unix environments.
 
-## Pull Requests
+## Architecture
 
-We actively welcome your pull requests.
+We target Node.js LTS and stable environments, and aim for basic modern browser support when possible.  
+In order to facilitate simple contributions, we avoided any kind of build steps.
 
-1. Fork the repo and create your branch from `master`.
-2. If you've added code that should be tested, add tests.
-3. If you've changed APIs, update the documentation.
-4. Ensure the test suite passes.
-5. Make sure your code lints.
+If you need to add new API routes, please add them to the [open-api](https://github.com/netlify/open-api) repo. 
+This client will automatically inherent the new routes from that module.
+
+Projects that depend heavily on this client that should be taken into consideration when making changes:
+
+- [netlify/cli](https://github.com/netlify/cli)
+
+## Releasing
+
+```console
+# Make changes
+# Update the changelog
+$ npm version [major|minor|patch]
+$ git push && git push --tags
+# Create a github release with the changelog contents 
+$ npm publish
+```
 
 ## License