Update README.md

Author: jackparmer

README.md

@@ -1,3 +1,96 @@
-# plotly.js
+# [plotly.js](https://plot.ly/javascript/getting-started/)
 
-The premier high-level javascript graphing library
+[![npm version](https://img.shields.io/npm/v/plotly.svg)](https://www.npmjs.com/package/plotly)
+
+To get started, check out <https://plot.ly/javascript/getting-started/>!
+
+## Table of contents
+
+* [Quick start](#quick-start)
+* [Bugs and feature requests](#bugs-and-feature-requests)
+* [Documentation](#documentation)
+* [Contributing](#contributing)
+* [Community](#community)
+* [Creators](#creators)
+* [Copyright and license](#copyright-and-license)
+
+
+## Quick start
+
+Several quick start options are available:
+
+* [Download the latest release](https://github.com/plotly/plotly.js/releases/v1.0.0/plotly.js.zip).
+* Clone the repo: `git clone https://github.com/plotly/plotly.js.git`.
+* Install with [npm](https://www.npmjs.com): `npm install plotly`.
+
+Read the [Getting started page](https://plot.ly/javascript/getting-started/) for examples.
+
+## Bugs and feature requests
+
+Have a bug or a feature request? Please first read the [issue guidelines](https://github.com/plotly/plotly.js/blob/master/CONTRIBUTING.md) and search for existing and closed issues. If your problem or idea is not addressed yet, [please open a new issue](https://github.com/plotly/plotly.js/issues/new).
+
+## Documentation
+
+Plotly.js documentation, in the repo documentation, is built with [Jekyll](http://jekyllrb.com) and publicly hosted on GitHub Pages at <https://plot.ly/javascript/getting-started/>. The docs may also be run locally.
+
+You can also suggest new documentation examples by submitting a [Codepen](http://codepen.io/tag/plotly/) on community.plot.ly (tagged [`plotly-js`](community.plot.ly/c/plotly-js).
+
+### Running documentation locally
+
+1. If necessary, [install Jekyll](http://jekyllrb.com/docs/installation) (requires v3.0.x).
+   **Note for Windows users:** Read [this unofficial guide](http://jekyll-windows.juthilo.com/) to get Jekyll up and running without problems.
+2. Make sure that you're on the ```source``` branch.
+3. From the root `/documentation` directory, run `jekyll serve` in the command line.
+4. Open `http://localhost:8000` in your browser, and voilà.
+
+Learn more about using Jekyll by reading its [documentation](http://jekyllrb.com/docs/home/).
+
+## Contributing
+
+Please read through our [contributing guidelines](https://github.com/plotly/plotly.js/blob/master/CONTRIBUTING.md). Included are directions for opening issues, coding standards, and notes on development.
+
+## Community
+
+Get updates on plotly.js's development and chat with the project maintainers and community members.
+
+* Follow [@plotlygraphs on Twitter](https://twitter.com/plotlygraphs).
+* Implementation help may be found at Stack Overflow (tagged [`plotly`](https://stackoverflow.com/questions/tagged/plotly)) or community.plot.ly (tagged [`plotly-js`](community.plot.ly/c/plotly-js).
+* Developers should use the keyword `plotly` on packages which modify or add to the functionality of plotly.js when distributing through [npm](https://www.npmjs.com/browse/keyword/plotly) or similar delivery mechanisms for maximum discoverability.
+* Direct developer email support can be purchased through a [Plotly Pro](https://plot.ly/products/cloud/) plan.
+
+## Versioning
+
+For transparency into our release cycle and in striving to maintain backward compatibility, plotly.js is maintained under [the Semantic Versioning guidelines](http://semver.org/). 
+
+See [the Releases section of our GitHub project](https://github.com/plotly/plotly.js/releases) for changelogs for each release version of plotly.js.
+
+
+## Creators
+
+**Alex C. Johnson**
+
+* <https://github.com/alexcjohnson>
+
+**Étienne Tétreault-Pinard**
+
+* <https://twitter.com/fat>
+* <https://github.com/fat>
+
+**Mikola Lysenko**
+
+* <https://twitter.com/MikolaLysenko>
+* <https://github.com/mikolalysenko>
+
+**Ben Postlethwaite**
+
+* <https://github.com/bpostlethwaite>
+
+**Chris Parmer**
+
+* <https://github.com/chriddyp>
+
+## Copyright and license
+
+Code and documentation copyright 2015 Plotly, Inc. 
+Code released under [the MIT license](https://github.com/plotly/plotly.js/blob/master/LICENSE). 
+Docs released under [Creative Commons](https://github.com/plotly/documentation/blob/source/LICENSE).