[mbrookes]

I believe it's a mistake to try and cram everything into the README. We've gone the opposite direction with Material-UI.

Compare 0.x (before): https://github.com/callemall/material-ui/blob/master/README....

With v1-beta (after): 1.0-beta: https://github.com/callemall/material-ui/blob/v1-beta/README...