DevExpress
diff --git a/‎.md-lint/templates.json
+10 b/‎.md-lint/templates.json
+10
diff --git a/‎Gulpfile.js
+37-10 b/‎Gulpfile.js
+37-10
diff --git a/‎docs/README.md
+193-108 b/‎docs/README.md
+193-108
diff --git a/‎docs/articles/blog/2019-11-21-testcafe-v1-7-0-released.md
+15-15 b/‎docs/articles/blog/2019-11-21-testcafe-v1-7-0-released.md
+15-15
diff --git a/‎docs/articles/blog/2020-1-17-testcafe-v1-8-0-released.md
+2-2 b/‎docs/articles/blog/2020-1-17-testcafe-v1-8-0-released.md
+2-2
diff --git a/‎docs/articles/documentation/README.md
-7 b/‎docs/articles/documentation/README.md
-7
diff --git a/‎docs/articles/documentation/extending-testcafe/README.md
-37 b/‎docs/articles/documentation/extending-testcafe/README.md
-37
@@ -0,0 +1,10 @@
+{
+    "MD009": { "br_spaces": 2 },
+    "MD013": false,
+    "MD007": false,
+    "MD025": false,
+    "MD029": {"style": "ordered"},
+    "MD036": false,
+    "MD047": false,
+    "MD041": false
+}
@@ -468,25 +468,29 @@ gulp.task('test-client-legacy-travis-mobile', gulp.series('prepare-tests', 'test
 
 //Documentation
 gulp.task('generate-docs-readme', done => {
-    function generateItem (name, url, level) {
-        return ' '.repeat(level * 2) + '* [' + name + '](articles' + url + ')\n';
+    function buildItem (name, url, level) {
+        return `${' '.repeat(level * 2)}* ${url ? buildLink(name, url) : name}\n`;
     }
 
-    function generateDirectory (tocItems, level) {
+    function buildLink (name, url) {
+        return `[${name}](articles${url})`;
+    }
+
+    function buildDirectory (tocItems, level) {
         let res = '';
 
         tocItems.forEach(item => {
-            res += generateItem(item.name ? item.name : item.url, item.url, level);
+            res += buildItem(item.name ? item.name : item.url, item.url, level);
 
             if (item.content)
-                res += generateDirectory(item.content, level + 1);
+                res += buildDirectory(item.content, level + 1);
         });
 
         return res;
     }
 
-    function generateReadme (toc) {
-        const tocList = generateDirectory(toc, 0);
+    function buildReadme (toc) {
+        const tocList = buildDirectory(toc, 0);
 
         return '# Documentation\n\n> This is the documentation\'s development version. ' +
                'The functionality described here may not be included in the current release version. ' +
@@ -496,7 +500,7 @@ gulp.task('generate-docs-readme', done => {
     }
 
     const toc    = yaml.safeLoad(fs.readFileSync('docs/nav/nav-menu.yml', 'utf8'));
-    const readme = generateReadme(toc);
+    const readme = buildReadme(toc);
 
     fs.writeFileSync('docs/README.md', readme);
 
@@ -522,6 +526,7 @@ gulp.task('lint-docs', () => {
         '!docs/articles/faq/**/*.md',
         '!docs/articles/documentation/recipes/**/*.md',
         '!docs/articles/blog/**/*.md',
+        '!docs/articles/templates/**/*.md',
         'examples/**/*.md'
     ]).then(files => {
         return lintFiles(files, require('./.md-lint/docs.json'));
@@ -545,10 +550,16 @@ gulp.task('lint-docs', () => {
         return lintFiles(files, require('./.md-lint/recipes.json'));
     });
 
+    const lintTemplates = globby([
+        'docs/articles/templates/**/*.md'
+    ]).then(files => {
+        return lintFiles(files, require('./.md-lint/templates.json'));
+    });
+
     const lintReadme    = lintFiles('README.md', require('./.md-lint/readme.json'));
     const lintChangelog = lintFiles('CHANGELOG.md', require('./.md-lint/changelog.json'));
 
-    return Promise.all([lintDocsAndExamples, lintReadme, lintChangelog, lintRecipes, lintFaq, lintBlog]);
+    return Promise.all([lintDocsAndExamples, lintReadme, lintChangelog, lintRecipes, lintFaq, lintBlog, lintTemplates]);
 });
 
 gulp.task('clean-website', () => {
@@ -601,7 +612,23 @@ gulp.step('put-in-tweets', () => {
         .pipe(gulp.dest('site/src/_data'));
 });
 
-gulp.step('put-in-website-content', gulp.parallel('put-in-articles', 'put-in-navigation', 'put-in-posts', 'put-in-publications', 'put-in-tweets', 'put-in-community-content', 'put-in-courses'));
+gulp.step('put-in-templates', () => {
+    return gulp
+        .src('docs/articles/templates/**/*')
+        .pipe(gulp.dest('site/src/_includes'));
+});
+
+gulp.step('put-in-website-content', gulp.parallel('put-in-articles', 'put-in-navigation', 'put-in-posts', 'put-in-publications', 'put-in-tweets', 'put-in-templates', 'put-in-community-content', 'put-in-courses'));
+
+gulp.step('prepare-website-content', gulp.series('clean-website', 'fetch-assets-repo', 'put-in-website-content'));
+
+gulp.step('put-in-templates', () => {
+    return gulp
+        .src('docs/articles/templates/**/*')
+        .pipe(gulp.dest('site/src/_includes'));
+});
+
+gulp.step('put-in-website-content', gulp.parallel('put-in-articles', 'put-in-navigation', 'put-in-posts', 'put-in-publications', 'put-in-tweets', 'put-in-templates'));
 gulp.step('prepare-website-content', gulp.series('clean-website', 'fetch-assets-repo', 'put-in-website-content'));
 
 gulp.step('prepare-website', gulp.parallel('lint-docs', 'prepare-website-content'));
 
@@ -15,7 +15,7 @@ This release introduces access to the browser and platform information from test
 
 TestCafe now allows you to obtain information about the current user agent. These data identify the operating system, platform type, browser, engine, etc.
 
-Use the [t.browser](../documentation/test-api/identify-the-browser-and-platform.md) property to access user agent data.
+Use the [t.browser](../documentation/reference/test-api/testcontroller/browser.md) property to access user agent data.
 
 ```js
 import { Selector } from 'testcafe';
@@ -29,21 +29,21 @@ test('My test', async t => {
 });
 ```
 
-The [t.browser](../documentation/test-api/identify-the-browser-and-platform.md) object exposes the following properties:
+The [t.browser](../documentation/reference/test-api/testcontroller/browser.md) object exposes the following properties:
 
 Property | Type | Description   | Example
 -------- | ---- | ------------- | -------
-[alias](../documentation/test-api/identify-the-browser-and-platform.md#alias) | String | The browser alias string specified when tests were launched. | `firefox:headless`
-[name](../documentation/test-api/identify-the-browser-and-platform.md#name) | String | The browser name. | `Chrome`
-[version](../documentation/test-api/identify-the-browser-and-platform.md#version) | String | The browser version. | `77.0.3865.120`
-[platform](../documentation/test-api/identify-the-browser-and-platform.md#platform) | String | The platform type. | `desktop`
-[headless](../documentation/test-api/identify-the-browser-and-platform.md#headless) | Boolean | `true` if the browser runs in headless mode. | `false`
-[os](../documentation/test-api/identify-the-browser-and-platform.md#os) | Object | The name and version of the operating system. | `{ name: 'macOS', version: '10.15.1' }`
-[engine](../documentation/test-api/identify-the-browser-and-platform.md#engine) | Object | The name and version of the browser engine. |  `{ name: 'Gecko', version: '20100101' }`
-[userAgent](../documentation/test-api/identify-the-browser-and-platform.md#useragent) | String | The user agent string. | `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/77.0.3865.120 Safari/537.36`
-[prettyUserAgent](../documentation/test-api/identify-the-browser-and-platform.md#prettyuseragent) | String | Formatted string with the browser's and operating system's name and version. | `Chrome 77.0.3865.75 / macOS 10.14.0`
-
-The following example shows how to create a [beforeEach](../documentation/test-api/test-code-structure.md#test-hooks) hook that runs for specific [browser engines](../documentation/test-api/identify-the-browser-and-platform.md#engine).
+[alias](../documentation/reference/test-api/testcontroller/browser.md#alias) | String | The browser alias string specified when tests were launched. | `firefox:headless`
+[name](../documentation/reference/test-api/testcontroller/browser.md#name) | String | The browser name. | `Chrome`
+[version](../documentation/reference/test-api/testcontroller/browser.md#version) | String | The browser version. | `77.0.3865.120`
+[platform](../documentation/reference/test-api/testcontroller/browser.md#platform) | String | The platform type. | `desktop`
+[headless](../documentation/reference/test-api/testcontroller/browser.md#headless) | Boolean | `true` if the browser runs in headless mode. | `false`
+[os](../documentation/reference/test-api/testcontroller/browser.md#os) | Object | The name and version of the operating system. | `{ name: 'macOS', version: '10.15.1' }`
+[engine](../documentation/reference/test-api/testcontroller/browser.md#engine) | Object | The name and version of the browser engine. |  `{ name: 'Gecko', version: '20100101' }`
+[userAgent](../documentation/reference/test-api/testcontroller/browser.md#useragent) | String | The user agent string. | `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/77.0.3865.120 Safari/537.36`
+[prettyUserAgent](../documentation/reference/test-api/testcontroller/browser.md#prettyuseragent) | String | Formatted string with the browser's and operating system's name and version. | `Chrome 77.0.3865.75 / macOS 10.14.0`
+
+The following example shows how to create a [beforeEach](../documentation/reference/test-api/fixture/beforeeach.md) hook that runs for specific [browser engines](../documentation/reference/test-api/testcontroller/browser.md#engine).
 
 ```js
 import { Selector } from 'testcafe';
@@ -57,7 +57,7 @@ fixture `My fixture`
     });
 ```
 
-You can also use [t.browser](../documentation/test-api/identify-the-browser-and-platform.md) to generate the screenshot path based on the [browser name](../documentation/test-api/identify-the-browser-and-platform.md#name). This prevents screenshots taken with [t.takeElementScreenshot](../documentation/test-api/actions/take-screenshot.md#take-a-screenshot-of-a-page-element) in different browsers from being overwritten.
+You can also use [t.browser](../documentation/reference/test-api/testcontroller/browser.md) to generate the screenshot path based on the [browser name](../documentation/reference/test-api/testcontroller/browser.md#name). This prevents screenshots taken with [t.takeElementScreenshot](../documentation/reference/test-api/testcontroller/takeelementscreenshot.md) in different browsers from being overwritten.
 
 ```js
 import { Selector } from 'testcafe';
@@ -72,7 +72,7 @@ test('My test', async t => {
 });
 ```
 
-For more information and examples, see [Identify the Browser and Platform](../documentation/test-api/identify-the-browser-and-platform.md).
+For more information and examples, see [Identify the Browser and Platform](../documentation/guides/advanced-guides/detect-the-client-browser-and-platform.md).
 
 ## Bug Fixes
 
 
@@ -11,7 +11,7 @@ In this release, we have added support for the new Chromium-based Microsoft Edge
 
 ## 🌟 Support for the New Microsoft Edge
 
-TestCafe v1.8.0 supports the new Microsoft Edge based on Chromium. The new Edge is available under the same [alias](../documentation/using-testcafe/common-concepts/browsers/browser-support.md#locally-installed-browsers): `edge`.
+TestCafe v1.8.0 supports the new Microsoft Edge based on Chromium. The new Edge is available under the same [alias](../documentation/guides/concepts/browsers.md#locally-installed-browsers): `edge`.
 
 ```sh
 testcafe edge test.js
@@ -24,7 +24,7 @@ await runner
     .run();
 ```
 
-Supported Edge's features include [headless mode](../documentation/using-testcafe/common-concepts/browsers/testing-in-headless-mode.md), [mobile device emulation](../documentation/using-testcafe/common-concepts/browsers/using-chromium-device-emulation.md), and [video recording](../documentation/using-testcafe/common-concepts/screenshots-and-videos.md#record-videos).
+Supported Edge's features include [headless mode](../documentation/guides/concepts/browsers.md#test-in-headless-mode), [mobile device emulation](../documentation/guides/concepts/browsers.md#use-chromium-device-emulation), and [video recording](../documentation/guides/advanced-guides/screenshots-and-videos.md#record-videos).
 
 ## Bug Fixes