Merge pull request #314 from DanChadwick/wip/v1.0.0

CONTRIBUTING.md, initial commit, WIP.

CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to ember-paper
+
+## Coordination, communication and community
+
+Many ember-paper contributor hang out on the [ember-paper channel on slack](https://embercommunity.slack.com/messages/ember-paper/). Not a slack user? [Get your invitation.](https://ember-community-slackin.herokuapp.com/)
+
+## Coding style
+
+* ember-paper uses the [ember-suave](https://github.com/DockYard/ember-suave) coding style.
+
+* Before submitting a pull request,
+check for coding style issues with  `jscs -c .jscsrc app addon`.
+
+## Actions
+
+* Action closures are preferred to strings representing action names.
+
+* Properties representing an action should be camelCased, e.g. `onClose`, rather than `on-close`.
+
+## Importing
+
+* Import the module, then use const object destructing to extract the desired methods. For example,
+```javascript
+import Ember from 'ember';
+const { computed } = Ember;
+```
+
+* When the destructured object assignment statement exceeds 80 columns, put each variable it its own line:
+```javascript
+const {
+  $,
+  Mixin,
+  String: { htmlSafe },
+  RSVP: { Promise },
+  computed,
+  on,
+  inject: { service },
+  run: { scheduleOnce }
+} = Ember;
+```
+* Order the imported variables in order of appearance, or other logical order.
+
+## Converting components from Angular Material
+
+* Use an ember-paper name for components. Convert angular elements attributes to ember boolean properties.
+```javascript
+<md-tabs md-dynamic-height md-border-bottom>
+```
+becomes
+```javascript
+{{paper-tabs dynamicHeight=true borderBottom=true}}
+```
+
+* Seek to provide feature parity using Angular Material styles, but implemented in an Ember-centric way.

README.md

@@ -41,9 +41,10 @@ We also need to allow `data:` in `img-src` because of a [current hack](https://g
 
 You can find out more information on the CSP addon page [here](https://github.com/rwjblue/ember-cli-content-security-policy#ember-cli-content-security-policy).
 
-## Contribution
+## Contributing
 
 This is a very ambitious project. Google's design specs are extensive, and not trivial to implement. `ember-paper` is heavily based on [Angular Material](https://github.com/angular/material) and [Web Starter Kit (material-sprint branch)](https://github.com/google/web-starter-kit/tree/material-sprint). These seem to be the most useful resources at the moment. If you feel like porting or fixing an element or two, please drop a pull request or issue at GitHub!
 
+I believe that with the help of everyone we can bring these amazing design spec to Ember in a modular and robust way. The Ember way.
 
-I believe that with the help of everyone we can bring these amazing design spec to Ember in a modular and robust way. The Ember way. **Help us on Github!**
+Read our [Contributing Guide](CONTRIBUTING.md) and **help us on Github!**