Reorganize docs; rewrite README

docs/components/Image.md

@@ -0,0 +1,66 @@
+# Image spec
+
+#### PropTypes
+
+All other props are transferred directly to the `element`.
+
++ `accessibilityLabel`: `string`
++ `async`: `bool` (TODO)
++ `className`: `string`
++ `source`: `string`
++ `style`: `ImageStylePropTypes`
+
+#### ImageStylePropTypes
+
++ `BackgroundPropTypes`
++ `BorderThemePropTypes`
++ `LayoutPropTypes`
++ `opacity`: `string`
+
+#### Examples
+
+```js
+import {Image} from 'react-web-sdk';
+import React, {PropTypes} from 'react';
+
+class Avatar extends React.Component {
+  static propTypes = {
+    size: PropTypes.oneOf(['small', 'normal', 'large']),
+    user: PropTypes.object
+  }
+
+  static defaultProps = {
+    size: 'normal'
+  }
+
+  render() {
+    return (
+      <Image
+        accessibilityLabel={`${user.name}'s profile picture`}
+        source={user.avatarUrl}
+        style={ ...style.base, ...style[this.props.size] }
+      />
+    );
+  }
+}
+
+const style = {
+  base: {
+    borderColor: 'white',
+    borderRadius: '5px',
+    borderWidth: '5px'
+  },
+  small: {
+    height: '32px',
+    width: '32px'
+  },
+  normal: {
+    height: '48px',
+    width: '48px'
+  },
+  large: {
+    height: '64px',
+    width: '32px'
+  }
+}
+```