docs: remove needless references to ember-decorators

Author: chriskrycho

README.md

@@ -89,7 +89,7 @@ ember install ember-decorators@^3.1.0 @ember-decorators/babel-transforms@^3.1.0
 
 #### Update ember-decorators
 
-Follow the same process of deduplication, reinstallation, and re-deduplication as described for ember-cli-babel above. This will get you the latest version of ember-decorators and, importantly, its @ember-decorators/babel-transforms dependency.
+If you're on a version of Ember before 3.10, follow the same process of deduplication, reinstallation, and re-deduplication as described for ember-cli-babel above for ember-decorators. This will get you the latest version of ember-decorators and, importantly, its @ember-decorators/babel-transforms dependency.
 
 #### Update ember-cli-typescript
 

docs/SUMMARY.md

@@ -4,7 +4,7 @@
 * [Installation](installation.md)
 * [Configuration](configuration.md)
 * [TypeScript and Ember](ts/README.md)
-  * [Using TypeScript with Ember effectively](ts/using-ts-effectively.md)
+  * [Using TypeScript With Ember Effectively](ts/using-ts-effectively.md)
   * [Decorators](ts/decorators.md)
   * [Current limitations](ts/current-limitations.md)
   * [Building Addons in TypeScript](ts/with-addons.md)

docs/cookbook/README.md

@@ -6,5 +6,7 @@ This “cookbook” section contains recipes for various scenarios you may encou
 Have an idea for an item that should fit here? [Open an issue for it!](https://github.com/typed-ember/ember-cli-typescript/issues/new/choose) We'd love to help you help us make this experience more awesome for everyone.
 {% endhint %}
 
-* Working with route models
+## Contents
+
+* [Working with route models](./working-with-route-models.md)
 

docs/ts/README.md

@@ -6,3 +6,10 @@ This guide covers the common details and "gotchas" of using TypeScript with Embe
 * [TypeScript Deep Dive](https://basarat.gitbook.io/typescript/)
 * [Ember docs](https://emberjs.com/learn/)
 
+## Outline
+
+* [Using TypeScript With Ember Effectively](using-ts-effectively.md)
+* [Decorators](decorators.md)
+* [Current limitations](current-limitations.md)
+* [Building Addons in TypeScript](with-addons.md)
+* [Understanding the Package Names](package-names.md)

docs/ts/current-limitations.md

@@ -1,16 +1,10 @@
-# Current limitations
+# Current Limitations
 
 While TS already works nicely for many things in Ember, there are a number of corners where it _won't_ help you out. Some of them are just a matter of further work on updating the [existing typings](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/ember); others are a matter of further support landing in TypeScript itself, or changes to Ember's object model.
 
 ## Some `import`s don't resolve
 
-You'll frequently see errors for imports which TypeScript doesn't know how to resolve. For example, if you use Ember Concurrency today and try to import its `task` helper:
-
-```typescript
-import { task } from 'ember-concurrency';
-```
-
-You'll see an error, because there aren't yet type definitions for it. You may see the same with some addons as well. **These won't stop the build from working;** they just mean TypeScript doesn't know where to find those.
+You'll frequently see errors for imports which TypeScript doesn't know how to resolve. **These won't stop the build from working;** they just mean TypeScript doesn't know where to find those.
 
 Writing these missing type definitions is a great way to pitch in! Jump in `#e-typescript` on the [Ember Community Discord server](https://discord.gg/zT3asNS) and we'll be happy to help you.
 
@@ -20,29 +14,48 @@ Templates are currently totally non-type-checked. This means that you lose any s
 
 Addons need to import templates from the associated `.hbs` file to bind to the layout of any components they export. The TypeScript compiler will report that it cannot resolve the module, since it does not know how to resolve files ending in `.hbs`. To resolve this, you can provide this set of definitions to `my-addon/types/global.d.ts`, which will allow the import to succeed:
 
- declare module '\*/template' { import { TemplateFactory } from 'htmlbars-inline-precompile';
-
-const template: TemplateFactory; export default template; }
-
-declare module 'app/templates/\*' { import { TemplateFactory } from 'htmlbars-inline-precompile';
+```ts
+declare module '\*/template' {
+  import { TemplateFactory } from 'htmlbars-inline-precompile';
+  const template: TemplateFactory; export default template;
+}
 
-const template: TemplateFactory; export default template; }
 
-declare module 'addon/templates/\*' { import { TemplateFactory } from 'htmlbars-inline-precompile';
+declare module 'app/templates/\*' {
+  import { TemplateFactory } from 'htmlbars-inline-precompile';
+  const template: TemplateFactory; export default template;
+}
 
-const template: TemplateFactory; export default template; } 
+declare module 'addon/templates/\*' {
+  import { TemplateFactory } from 'htmlbars-inline-precompile';
+  const template: TemplateFactory; export default template;
+}
+```
 
 ## Invoking actions
 
 TypeScript won't detect a mismatch between this action and the corresponding call in the template:
 
- import Component from '@ember/component'; import { action } from '@ember-decorators/object';
+```ts
+import Component from '@ember/component';
+import { action } from '@ember/object';
 
-export default class MyGame extends Component { @action turnWheel\(degrees: number\) { // ... } } 
+export default class MyGame extends Component {
+  @action turnWheel(degrees: number) {
+    // ... 
+  }
+} 
+```
 
+```hbs
+<button {{on "click" (fn this.turnWheel "potato")}}>
 Click Me 
+</button>
+```
 
 Likewise, it won't notice a problem when you use the `send` method:
 
- // TypeScript compiler won't detect this type mismatch this.send\('turnWheel', 'ALSO-NOT-A-NUMBER'\); 
-
+```ts
+// TypeScript compiler won't detect this type mismatch
+this.send\('turnWheel', 'ALSO-NOT-A-NUMBER'\);
+```