Update README with link to GOVERNANCE and API docs.

README.md

@@ -1,6 +1,39 @@
-Phosphor
-========
+# PhosphorJS
 
 [![Build Status](https://travis-ci.org/phosphorjs/phosphor.svg?branch=master)](https://travis-ci.org/phosphorjs/phosphor)
 
-The [PhosphorJS](http://phosphorjs.github.io/) library.
+PhosphorJS is a set of JavaScript packages, written in TypeScript, that provide
+a rich set of widgets, layouts, events, and data structures. These enable
+developers to construct advanced, production-quality, desktop-like web
+applications that would be otherwise impossible using CSS alone.
+
+See the [PhosphorJS website](http://phosphorjs.github.io/) for more information.
+
+## Documentation
+
+The API documentation for the phosphor packages can be found in the links below:
+
+* [algorithm](http://phosphorjs.github.io/phosphor/api/algorithm/globals.html)
+* [application](http://phosphorjs.github.io/phosphor/api/application/globals.html)
+* [commands](http://phosphorjs.github.io/phosphor/api/commands/globals.html)
+* [coreutils](http://phosphorjs.github.io/phosphor/api/coreutils/globals.html)
+* [disposable](http://phosphorjs.github.io/phosphor/api/disposable/globals.html)
+* [domutils](http://phosphorjs.github.io/phosphor/api/domutils/globals.html)
+* [dragdrop](http://phosphorjs.github.io/phosphor/api/dragdrop/globals.html)
+* [keyboard](http://phosphorjs.github.io/phosphor/api/keyboard/globals.html)
+* [messaging](http://phosphorjs.github.io/phosphor/api/messaging/globals.html)
+* [properties](http://phosphorjs.github.io/phosphor/api/properties/globals.html)
+* [signaling](http://phosphorjs.github.io/phosphor/api/signaling/globals.html)
+* [virtualdom](http://phosphorjs.github.io/phosphor/api/virtualdom/globals.html)
+* [widgets](http://phosphorjs.github.io/phosphor/api/widgets/globals.html)
+
+
+## Governance
+
+PhosphorJS is led by a Chief Executive, Chris Colbert, and team of Package
+Maintainers according to the Principles of Phosphor. See our [Governance
+Document](https://github.com/phosphorjs/phosphor/blob/master/GOVERNANCE.md) for
+details.
+
+
+