Documentation site upgrade (#979)

config/ember-try.js

@@ -101,8 +101,12 @@ module.exports = function() {
           npm: {
             devDependencies: {
               'ember-data': '~3.24.0',
-              'ember-cli-addon-docs': '^1.0.0',
+              'ember-cli-addon-docs': '^5.1.0',
               'ember-cli-addon-docs-yuidoc': '^1.0.0',
+              'ember-cli-deploy': '^1.0.2',
+              'ember-cli-deploy-build': '^1.1.1',
+              'ember-cli-deploy-git': '^1.3.3',
+              'ember-cli-deploy-git-ci': '^1.0.1',
             },
           },
         },

package.json

@@ -60,10 +60,6 @@
     "ember-auto-import": "^2.4.2",
     "ember-cli": "~3.28.0",
     "ember-cli-dependency-checker": "^3.2.0",
-    "ember-cli-deploy": "^1.0.2",
-    "ember-cli-deploy-build": "^1.1.1",
-    "ember-cli-deploy-git": "^1.3.3",
-    "ember-cli-deploy-git-ci": "^1.0.1",
     "ember-cli-eslint": "^5.1.0",
     "ember-cli-inject-live-reload": "^2.0.1",
     "ember-cli-sass": "^10.0.0",
@@ -114,7 +110,7 @@
     }
   },
   "volta": {
-    "node": "14.18.2",
-    "yarn": "1.22.17"
+    "node": "18.15.0",
+    "yarn": "1.22.19"
   }
 }

tests/acceptance/docs-test.js

@@ -74,7 +74,7 @@ module('Acceptance | docs', function(hooks) {
 
     let navItems = Array.from(nav.querySelectorAll('li'));
 
-    let expectedNavItems = ['API REFERENCE', '{{ember-table}}'];
+    let expectedNavItems = ['API REFERENCE', '<EmberTable/​>'];
 
     expectedNavItems.forEach(expectedText => {
       assert.ok(

tests/dummy/app/app.js

@@ -1,25 +1,12 @@
-/* globals define, require */
 import Application from '@ember/application';
-import Resolver from './resolver';
+import Resolver from 'ember-resolver';
 import loadInitializers from 'ember-load-initializers';
-import config from './config/environment';
-import EmberRouter from '@ember/routing/router';
+import config from 'dummy/config/environment';
 
-// Including ember-cli-addon-docs breaks certain versions of Ember when testing
-// but they also break if we remove it. This defines a stub router which should
-// prevent breakage.
-if (!require.entries['ember-cli-addon-docs/router']) {
-  define('ember-cli-addon-docs/router', () => {
-    return EmberRouter;
-  });
+export default class App extends Application {
+  modulePrefix = config.modulePrefix;
+  podModulePrefix = config.podModulePrefix;
+  Resolver = Resolver;
 }
 
-const App = Application.extend({
-  modulePrefix: config.modulePrefix,
-  podModulePrefix: config.podModulePrefix,
-  Resolver,
-});
-
 loadInitializers(App, config.modulePrefix);
-
-export default App;

tests/dummy/app/pods/components/custom-row/component.js → tests/dummy/app/components/custom-row/component.js

@@ -1,4 +1,4 @@
-import EmberTableRow from '../../../components/ember-tr';
+import EmberTableRow from 'ember-table/components/ember-tr/component';
 
 export default EmberTableRow.extend({
   classNames: ['custom-row'],

tests/dummy/app/pods/docs/guides/header/sorting/empty-values/component.js → tests/dummy/app/components/examples/sorting-empty-values/component.js

@@ -1,7 +1,7 @@
 import Component from '@ember/component';
 import { computed } from '@ember/object';
 import faker from 'faker';
-import { getRandomInt } from '../../../../../../utils/generators';
+import { getRandomInt } from 'dummy/utils/generators';
 
 export default Component.extend({
   // BEGIN-SNIPPET docs-example-sorting-empty-values.js

tests/dummy/app/pods/docs/index/template.md → tests/dummy/app/components/index-content/template.md

@@ -1,7 +1,3 @@
-{{docs-hero
-  byline='the power table for power users'
-}}
-
 Ember Table is a power table made for users who need a full-fledged,
 fully-customizable table component for their apps. It is built to be flexible,
 scalable, and ergonomic for day-to-day use.

tests/dummy/app/pods/components/main/table-meta-data/cell-selection/component.js → tests/dummy/app/components/main/table-meta-data/cell-selection/component.js

@@ -1,6 +1,6 @@
 import Component from '@ember/component';
 import { computed } from '@ember/object';
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 
 export default Component.extend({
   rows: computed(function() {

tests/dummy/app/pods/docs/guides/header/columns/controller.js → tests/dummy/app/controllers/docs/guides/header/columns.js

@@ -1,6 +1,6 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 
 export default Controller.extend({
   rows: computed(function() {

tests/dummy/app/pods/docs/guides/header/fixed-columns/controller.js → tests/dummy/app/controllers/docs/guides/header/fixed-columns.js

@@ -2,7 +2,7 @@ import Controller from '@ember/controller';
 import { A as emberA } from '@ember/array';
 import { get, set } from '@ember/object';
 
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 import { computed } from '@ember/object';
 
 export default Controller.extend({

tests/dummy/app/pods/docs/guides/header/scroll-indicators/controller.js → tests/dummy/app/controllers/docs/guides/header/scroll-indicators.js

@@ -1,7 +1,7 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
 
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 
 export default Controller.extend({
   // BEGIN-SNIPPET docs-example-scroll-indicators.js

tests/dummy/app/pods/docs/guides/header/size-constraints/controller.js → tests/dummy/app/controllers/docs/guides/header/size-constraints.js

@@ -1,7 +1,7 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
 import { addObserver } from '@ember/object/observers'; // eslint-disable-line no-restricted-imports
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 
 const defaultResizeMode = {
   'eq-container': 'fluid',

tests/dummy/app/pods/docs/guides/header/sorting/controller.js → tests/dummy/app/controllers/docs/guides/header/sorting.js

@@ -1,7 +1,7 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
 import faker from 'faker';
-import { getRandomInt } from '../../../../../utils/generators';
+import { getRandomInt } from 'dummy/utils/generators';
 
 export default Controller.extend({
   // BEGIN-SNIPPET docs-example-sortings.js

tests/dummy/app/pods/docs/guides/header/subcolumns/controller.js → tests/dummy/app/controllers/docs/guides/header/subcolumns.js

@@ -1,7 +1,7 @@
 import Controller from '@ember/controller';
 import { A as emberA } from '@ember/array';
 import { computed } from '@ember/object';
-import { generateRows, generateColumn } from '../../../../../utils/generators';
+import { generateRows, generateColumn } from 'dummy/utils/generators';
 
 const COLUMN_COUNT = 4;
 

tests/dummy/app/pods/docs/guides/main/table-customization/controller.js → tests/dummy/app/controllers/docs/guides/main/table-customization.js

@@ -1,6 +1,6 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
-import { generateRows, getRandomInt } from '../../../../../utils/generators';
+import { generateRows, getRandomInt } from 'dummy/utils/generators';
 import faker from 'faker';
 
 export default Controller.extend({

tests/dummy/app/pods/docs/guides/main/table-meta-data/controller.js → tests/dummy/app/controllers/docs/guides/main/table-meta-data.js

@@ -1,6 +1,6 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
-import { generateRows } from '../../../../../utils/generators';
+import { generateRows } from 'dummy/utils/generators';
 
 export default Controller.extend({
   rows: computed(function() {

tests/dummy/app/pods/scenarios/performance/controller.js → tests/dummy/app/controllers/scenarios/performance.js

@@ -1,6 +1,6 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
-import { generateRows, generateColumns } from '../../../utils/generators';
+import { generateRows, generateColumns } from 'dummy/utils/generators';
 
 export default Controller.extend({
   rows: computed(function() {

tests/dummy/app/pods/scenarios/simple/controller.js → tests/dummy/app/controllers/scenarios/simple.js

@@ -1,6 +1,6 @@
 import Controller from '@ember/controller';
 import { computed } from '@ember/object';
-import { generateRows, generateColumns } from '../../../utils/generators';
+import { generateRows, generateColumns } from 'dummy/utils/generators';
 
 export default Controller.extend({
   rows: computed(function() {

tests/dummy/app/index.html

@@ -10,8 +10,8 @@
     {{content-for "head"}}
 
     <link rel="shortcut icon" href="/assets/images/favicon.png" />
-    <link rel="stylesheet" href="{{rootURL}}assets/vendor.css">
-    <link rel="stylesheet" href="{{rootURL}}assets/dummy.css">
+    <link integrity="" rel="stylesheet" href="{{rootURL}}assets/vendor.css">
+    <link integrity="" rel="stylesheet" href="{{rootURL}}assets/dummy.css">
 
     {{content-for "head-footer"}}
   </head>

tests/dummy/app/routes/index.js

@@ -0,0 +1,7 @@
+import Route from '@ember/routing/route';
+
+export default class IndexRoute extends Route {
+  redirect() {
+    this.transitionTo('docs');
+  }
+}

tests/dummy/app/templates/application.hbs

@@ -0,0 +1,5 @@
+<DocsHeader />
+
+{{outlet}}
+
+<DocsKeyboardShortcuts />

tests/dummy/app/templates/docs.hbs

@@ -0,0 +1,44 @@
+<DocsViewer as |viewer|>
+  <viewer.nav as |nav|>
+
+    <nav.section @label="Introduction" />
+
+    <nav.item @label='Introduction' @route='docs.index' />
+    <nav.item @label='Quickstart' @route='docs.quickstart' />
+    <nav.item @label='Why Ember Table?' @route='docs.why-ember-table' />
+
+    <nav.section @label='Guides' />
+
+    <nav.item @label='A Basic Table' @route='docs.guides.main.basic-table' />
+    <nav.item @label='Table Customization' @route='docs.guides.main.table-customization' />
+    <nav.item @label='Table Meta Data' @route='docs.guides.main.table-meta-data' />
+    <nav.item @label='Styling the Table' @route='docs.guides.main.styling-the-table' />
+    <nav.item @label='Infinite Scroll' @route='docs.guides.main.infinite-scroll' />
+
+    <nav.section @label='Header' />
+
+    <nav.item @label='Columns' @route='docs.guides.header.columns' />
+    <nav.item @label='Subcolumns' @route='docs.guides.header.subcolumns' />
+    <nav.item @label='Fixed Columns' @route='docs.guides.header.fixed-columns' />
+    <nav.item @label='Size Constraints' @route='docs.guides.header.size-constraints' />
+    <nav.item @label='Sorting' @route='docs.guides.header.sorting' />
+    <nav.item @label='Scroll Indicators' @route='docs.guides.header.scroll-indicators' />
+    <nav.item @label='Column Keys' @route='docs.guides.header.column-keys' />
+
+    <nav.section @label='Body' />
+
+    <nav.item @label='Rows and Trees' @route='docs.guides.body.rows-and-trees' />
+    <nav.item @label='Row Selection' @route='docs.guides.body.row-selection' />
+    <nav.item @label='Occlusion' @route='docs.guides.body.occlusion' />
+
+    <nav.section @label='Testing' />
+
+    <nav.item @label='Table Test Page' @route='docs.testing.test-page' />
+
+  </viewer.nav>
+
+  <viewer.main>
+    {{outlet}}
+  </viewer.main>
+
+</DocsViewer>

tests/dummy/app/pods/docs/guides/body/row-selection/template.md → tests/dummy/app/templates/docs/guides/body/row-selection.md

@@ -6,7 +6,7 @@ to control the selection using DDAU:
 
 {{#docs-demo as |demo|}}
   {{#demo.example name="docs-example-row-selection"}}
-    {{docs/guides/body/row-selection/examples/row-selection
+    {{examples/row-selection
       rows=this.rows
       columns=this.columns}}
   {{/demo.example}}
@@ -27,7 +27,7 @@ selected, all of its children _must_ be selected:
 
 {{#docs-demo as |demo|}}
   {{#demo.example name="selected-rows"}}
-    {{docs/guides/body/row-selection/examples/selected-rows
+    {{examples/selected-rows
       rowWithChildren=this.rowWithChildren
       columns=this.columns
       preselection=this.preselection}}
@@ -68,7 +68,7 @@ itself.
 
 {{#docs-demo as |demo|}}
   {{#demo.example name='selection-modes'}}
-    {{docs/guides/body/row-selection/examples/selection-modes
+    {{examples/selection-modes
       columns=this.columns
       rowsWithChildren=this.rowsWithChildren
       rowSelectionMode=this.rowSelectionMode

tests/dummy/app/pods/docs/guides/header/columns/template.md → tests/dummy/app/templates/docs/guides/header/columns.md

@@ -62,7 +62,8 @@ of each individual column and constraints for the widths. Widths are controlled
 by the component, and if you don't provide one they'll use automatic defaults.
 If you don't want to provide widths, but want your table to grow or shrink to
 a suitable size in its container, you should take a look at
-{{link-to 'width constraints' 'docs.guides.header.size-constraints'}}.
+{{#link-to route='docs.guides.header.size-constraints'}}width
+constraints{{/link-to}}.
 
 If you do provide a width, changes to width via resizing will be reflected onto
 your column object. This allows you to share, save, and reuse the widths that

tests/dummy/app/pods/docs/guides/header/fixed-columns/template.md → tests/dummy/app/templates/docs/guides/header/fixed-columns.md

@@ -53,7 +53,7 @@ you can make fixed columns toggleable for your users.
 
 {{#docs-demo as |demo|}}
   {{#demo.example name='dynamic-fixed-columns'}}
-    {{docs/guides/header/fixed-columns/dynamic-example
+    {{examples/fixed-columns-dynamic
       rows=this.rows
       columns=dynamicFixedColumns
       toggleFixed=(action "toggleFixed")

tests/dummy/app/pods/docs/guides/header/sorting/template.md → tests/dummy/app/templates/docs/guides/header/sorting.md

@@ -134,4 +134,4 @@ This demo shows that in action:
 Empty values can be treated differently depending on the needs by using the `sortEmptyLast` option.
 To see its effect, try sorting the "Material" column in ascending order with and without "sortEmptyLast" checked.
 
-{{docs/guides/header/sorting/empty-values}}
+{{examples/sorting-empty-values}}

tests/dummy/app/pods/docs/guides/main/infinite-scroll/template.md → tests/dummy/app/templates/docs/guides/main/infinite-scroll.md

@@ -4,11 +4,11 @@ Infinite scroll is a common UI pattern where additional table rows are loaded as
 
 {{#docs-demo as |demo|}}
   {{#demo.example}}
-    {{docs/guides/main/infinite-scroll/example}}
+    {{examples/infinite-scroll}}
   {{/demo.example}}
 
   {{demo.snippet name='docs-example-infinite-scroll.hbs'}}
   {{demo.snippet label='component.js' name='docs-example-infinite-scroll.js'}}
 {{/docs-demo}}
 
-Ember Table does not provide a built-in spinner. You must specify your own by passing a block to `<t.loadingMore>` like in the example above. See the {{#link-to 'docs.api.item' 'components/ember-table-loading-more'}}`EmberTableLoadingMore`{{/link-to}} component docs for more information.
+Ember Table does not provide a built-in spinner. You must specify your own by passing a block to `<t.loadingMore>` like in the example above. See the {{#link-to route='docs.api.item' model='components/ember-table-loading-more'}}`EmberTableLoadingMore`{{/link-to}} component docs for more information.

tests/dummy/app/templates/docs/index.md

@@ -0,0 +1,3 @@
+<DocsHero @byline="the power table for power users" />
+
+<IndexContent />