Merge pull request aurelia#1319 from CollinHerber/master

chore(docs): add registering a custom element documentation

docs/user-docs/getting-to-know-aurelia/components/creating-components/README.md

@@ -51,5 +51,8 @@ If you want more control over your components or you are a plugin author, you mi
 
 {% page-ref page="using-customelement-decorator.md" %}
 
+## Register your Custom Element
 
+To enable the custom markup to be available within your template or globally you must register your element.
 
+{% page-ref page="consuming-a-custom-element.md" %}

docs/user-docs/getting-to-know-aurelia/components/creating-components/consuming-a-custom-element.md

@@ -0,0 +1,21 @@
+# Consuming a Custom Element
+In order to use a new component you must register your component either globally or within the component you would like to use it in.
+
+## Globally registering an element
+To register your component to be used globally within your application you will use `.register` in `main.ts`
+```javascript
+import Aurelia from 'aurelia';
+import { MyApp } from './my-app';
+import { SomeElement } from './path-to/some-element';
+
+Aurelia
+  .register(SomeElement)
+  .app(MyApp)
+  .start();
+  ```
+
+## Importing the element within the template
+Adding your element to be used within the template is as easy as adding the following line in your `.html` file.
+```html
+<import from="./path-to/some-element"></import>
+```