docs: restructure and use Gitbook style

Author: chriskrycho

.gitbook.yaml

@@ -1,4 +1,4 @@
 root: ./docs
 
 structure:
-  readme: ../index.md
+  readme: ./index.md

docs/SUMMARY.md

@@ -1,31 +1,13 @@
 # Table of contents
 
-* [Initial page](../index.md)
-* [Getting Started](getting-started/README.md)
-  * [Installation](getting-started/installation.md)
-  * [Configuration](getting-started/configuration.md)
-* [Working With Ember Classic](legacy/README.md)
-  * [EmberComponent](legacy/ember-component.md)
-  * [Mixins](legacy/mixins.md)
-  * [Computed Properties](legacy/computed-properties.md)
-  * [EmberObject](legacy/ember-object.md)
-  * [Legacy Ember Guide](legacy/overview.md)
-* [Working With Ember Data](ember-data/README.md)
-  * [Overview: Ember Data](ember-data/overview.md)
-  * [Models](ember-data/models.md)
-* [cookbook](cookbook/README.md)
-  * [Overview](cookbook/overview.md)
-  * [Working with route models](cookbook/working-with-route-models.md)
-* [type-defs](type-defs/README.md)
-  * [Understanding the Package Names](type-defs/package-names.md)
-* [Overview](index.md)
-* [ts](ts/README.md)
-  * [Building Addons in TypeScript](ts/with-addons.md)
-  * [TypeScript and Ember](ts/overview.md)
-  * [Decorators](ts/decorators.md)
+* [Installation](getting-started/installation.md)
+* [Configuration](getting-started/configuration.md)
+* [TypeScript and Ember](ts/README.md)
   * [Using TypeScript with Ember effectively](ts/using-ts-effectively.md)
+  * [Decorators](ts/decorators.md)
   * [Current limitations](ts/current-limitations.md)
-* [Upgrading from 1.x](upgrade-notes.md)
+  * [Building Addons in TypeScript](ts/with-addons.md)
+  * [Understanding the Package Names](type-defs/package-names.md)
 * [Working With Ember](ember/README.md)
   * [Controllers](ember/controllers.md)
   * [Services](ember/services.md)
@@ -34,6 +16,19 @@
   * [Components](ember/components.md)
   * [Helpers](ember/helpers.md)
   * [Routes](ember/routes.md)
-* [troubleshooting](troubleshooting/README.md)
+* [Working With Ember Data](ember-data/README.md)
+  * [Overview: Ember Data](ember-data/overview.md)
+  * [Models](ember-data/models.md)
+* [cookbook](cookbook/README.md)
+  * [Overview](cookbook/overview.md)
+  * [Working with route models](cookbook/working-with-route-models.md)
+* [Working With Ember Classic](legacy/README.md)
+  * [EmberComponent](legacy/ember-component.md)
+  * [Mixins](legacy/mixins.md)
+  * [Computed Properties](legacy/computed-properties.md)
+  * [EmberObject](legacy/ember-object.md)
+  * [Legacy Ember Guide](legacy/overview.md)
+* [Upgrading from 1.x](upgrade-notes.md)
+* [Troubleshooting](troubleshooting/README.md)
   * [Conflicting Type Dependencies](troubleshooting/conflicting-types.md)
 

docs/getting-started/configuration.md docs/configuration.mddocs/getting-started/configuration.md renamed to docs/configuration.md

@@ -1,2 +1,10 @@
-# cookbook
+# Cookbook
+
+This “cookbook” section contains recipes for various scenarios you may encounter while working on your app or addon.
+
+{% hint style="info" %}
+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
 

docs/cookbook/README.md

@@ -1,2 +1 @@
-# troubleshooting
-
+# Troubleshooting

docs/cookbook/overview.md

@@ -1,2 +1,8 @@
-# ts
+# TypeScript and Ember
+
+This guide covers the common details and "gotchas" of using TypeScript with Ember. Note that we do _not_ cover the use of TypeScript _or_ Ember in general—for those, you should refer to the corresponding documentation:
+
+* [TypeScript docs](https://www.typescriptlang.org/docs/index.html)
+* [TypeScript Deep Dive](https://basarat.gitbook.io/typescript/)
+* [Ember docs](https://emberjs.com/learn/)