Docs: reworking docs structure step 9.

godai78 · godai78 · commit eb737175e609 · 2021-10-12T12:42:05.000+02:00
diff --git a/README.md b/README.md
@@ -17,7 +17,7 @@ A set of ready-to-use rich text editors created with a powerful framework. Made
 ## Table of contents
 
 * [Quick start](#quick-start)
-   * [CKEditor 5 Builds](#ckeditor-5-builds)
+   * [CKEditor 5 builds](#ckeditor-5-builds)
    * [CKEditor 5 Framework](#ckeditor-5-framework)
 * [Documentation and FAQ](#documentation-and-faq)
 * [Contributing and project organization](#contributing-and-project-organization)
@@ -35,11 +35,11 @@ A set of ready-to-use rich text editors created with a powerful framework. Made
 
 ## Quick start
 
-### CKEditor 5 Builds
+### CKEditor 5 builds
 
-CKEditor 5 Builds are a set of ready-to-use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration.
+CKEditor 5 builds are a set of ready-to-use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration.
 
-The following CKEditor 5 Builds are currently available:
+The following CKEditor 5 builds are currently available:
 
 * [Classic editor](https://ckeditor.com/docs/ckeditor5/latest/builds/guides/overview.html#classic-editor)
 * [Inline editor](https://ckeditor.com/docs/ckeditor5/latest/builds/guides/overview.html#inline-editor)
@@ -84,7 +84,7 @@ To find out how to start with other builds check the [Quick start guide in the C
 
 ### CKEditor 5 Framework
 
-CKEditor 5 Builds allow you to quickly and easily initialize one of the many types of editors in your application. At the same time, CKEditor 5 is also a framework for creating custom-made rich text editing solutions.
+CKEditor 5 builds allow you to quickly and easily initialize one of the many types of editors in your application. At the same time, CKEditor 5 is also a framework for creating custom-made rich text editing solutions.
 
 To find out how to start building your own editor from scratch go to [CKEditor 5 Framework overview section of CKEditor 5 documentation](https://ckeditor.com/docs/ckeditor5/latest/framework/guides/overview.html).
 
@@ -94,7 +94,7 @@ To find out more see the following [CKEditor 5 documentation](https://ckeditor.c
 
 * [API documentation](https://ckeditor.com/docs/ckeditor5/latest/api/index.html)
 * [CKEditor 5 Framework documentation](https://ckeditor.com/docs/ckeditor5/latest/framework/index.html)
-* [CKEditor 5 Builds documentation](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html)
+* [CKEditor 5 builds documentation](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html)
 * [CKEditor 5 Features documentation](https://ckeditor.com/docs/ckeditor5/latest/features/index.html)
 * [CKEditor 5 Examples](https://ckeditor.com/docs/ckeditor5/latest/examples/index.html)
 
diff --git a/docs/api/index.md b/docs/api/index.md
@@ -18,8 +18,8 @@ category: api-reference
 ## Documentation
 
 * {@link framework/index CKEditor 5 Framework} &ndash; Learn how to develop with CKEditor 5 Framework, customize it and create plugins.
-* {@link builds/guides/overview CKEditor 5 Builds} &ndash; Learn how to install, integrate and configure CKEditor 5 Builds. More complex aspects, like creating custom builds, are explained here, too.
-* {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 Builds.
+* {@link builds/guides/overview CKEditor 5 builds} &ndash; Learn how to install, integrate and configure CKEditor 5 builds. More complex aspects, like creating custom builds, are explained here, too.
+* {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 builds.
 
 ## Contribute
 
diff --git a/docs/builds/guides/integration/advanced-setup.md b/docs/builds/guides/integration/advanced-setup.md
@@ -381,7 +381,7 @@ Webpack 4 introduced the [concept of modes](https://webpack.js.org/concepts/mode
 <info-box>
 	Prior to version 1.2.7 `uglifyjs-webpack-plugin` had a bug which caused webpack to crash with the following error: `TypeError: Assignment to constant variable.`. If you experienced this error, make sure that your `node_modules` contains an up-to-date version of this package (and that webpack uses this version).
 
-	CKEditor 5 Builds use [`Terser`](https://github.com/terser/terser) instead of `uglifyjs-webpack-plugin` because [the later one seems to be unsupported anymore](https://github.com/ckeditor/ckeditor5/issues/1353).
+	CKEditor 5 builds use [`Terser`](https://github.com/terser/terser) instead of `uglifyjs-webpack-plugin` because [the later one seems to be unsupported anymore](https://github.com/ckeditor/ckeditor5/issues/1353).
 </info-box>
 
 ### Option: Extracting CSS
@@ -441,7 +441,7 @@ Webpack will now create a separate file called `styles.css` which you will need
 
 ### Option: Building to ES5 target
 
-CKEditor 5 is written in ECMAScript 2015 (also called ES6). All browsers in which CKEditor 5 is {@link builds/guides/support/browser-compatibility currently supported} have sufficient ES6 support to run CKEditor 5. Thanks to that, CKEditor 5 Builds are also published in the original ES6 format.
+CKEditor 5 is written in ECMAScript 2015 (also called ES6). All browsers in which CKEditor 5 is {@link builds/guides/support/browser-compatibility currently supported} have sufficient ES6 support to run CKEditor 5. Thanks to that, CKEditor 5 builds are also published in the original ES6 format.
 
 However, it may happen that your environment requires ES5. For instance, if you use tools like the original [UglifyJS](https://github.com/mishoo/UglifyJS) which do not support ES6+ yet, you may need to transpile CKEditor 5 source to ES5. This will create ~80% bigger builds but will ensure that your environment can process CKEditor 5 code.
 
diff --git a/docs/builds/guides/migration/migration-from-ckeditor-4.md b/docs/builds/guides/migration/migration-from-ckeditor-4.md
@@ -15,7 +15,7 @@ When compared to its predecessor, CKEditor 5 should be considered **a totally ne
 
 There is no "drop in" solution for migrating. In this guide we hope to summarize the most important aspects you need to consider before you proceed with installing CKEditor 5.
 
-Before starting, be sure that migrating is your best choice. Refer to {@link builds/guides/overview#when-not-to-use-builds When NOT to use CKEditor 5 Builds?} for more information.
+Before starting, be sure that migrating is your best choice. Refer to {@link builds/guides/overview#when-not-to-use-builds When NOT to use CKEditor 5 builds?} for more information.
 
 ## Installation and integration
 
diff --git a/docs/builds/guides/overview.md b/docs/builds/guides/overview.md
@@ -11,11 +11,11 @@ order: 10
 
 # Overview
 
-Predefined CKEditor 5 Builds are a set of ready-to-use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration. They provide convenient solutions that can be installed with no effort and that satisfy the most common editing use cases.
+Predefined CKEditor 5 builds are a set of ready-to-use rich text editors. Every "build" provides a single type of editor with a set of features and a default configuration. They provide convenient solutions that can be installed with no effort and that satisfy the most common editing use cases.
 
 ## Available builds
 
-The following CKEditor 5 Builds are currently available:
+The following CKEditor 5 builds are currently available:
 
  * [Classic editor](#classic-editor)
  * [Inline editor](#inline-editor)
diff --git a/docs/builds/guides/support/license-and-legal.md b/docs/builds/guides/support/license-and-legal.md
@@ -8,7 +8,7 @@ order: 20
 
 # License and legal
 
-The following legal notices apply to CKEditor 5 Builds and all software from CKEditor 5 Ecosystem included with it.
+The following legal notices apply to CKEditor 5 builds and all software from CKEditor 5 Ecosystem included with it.
 
 Copyright (c) 2003-2021, CKSource Frederico Knabben. All rights reserved.
 
@@ -20,7 +20,7 @@ If you are running a project with an OSS license incompatible with GPL, please [
 
 ## Sources of intellectual property included in CKEditor
 
-Where not otherwise indicated, all CKEditor 5 Builds content is authored by CKSource engineers and consists of CKSource-owned intellectual property. In some specific instances, CKEditor will incorporate work done by developers outside of CKSource with their express permission.
+Where not otherwise indicated, all CKEditor 5 builds content is authored by CKSource engineers and consists of CKSource-owned intellectual property. In some specific instances, CKEditor will incorporate work done by developers outside of CKSource with their express permission.
 
 ## Trademarks
 
diff --git a/docs/builds/index.md b/docs/builds/index.md
@@ -3,8 +3,8 @@ category: builds
 order: 10
 toc: false
 feedback-widget: false
-meta-title: CKEditor 5 Builds documentation
-meta-description: Learn how to install, integrate, configure and develop CKEditor 5 Builds. Browse through API documentation and online samples.
+meta-title: CKEditor 5 builds documentation
+meta-description: Learn how to install, integrate, configure and develop CKEditor 5 builds. Browse through API documentation and online samples.
 ---
 
 # Installing CKEditor 5
@@ -40,4 +40,4 @@ Refer to the {@link builds/guides/migration/migration-from-ckeditor-4 CKEditor 4
 ## Related links
 
  * {@link examples/index Examples} &ndash; Try live demos of all available builds.
- * {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 Builds.
+ * {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 builds.
diff --git a/docs/examples/index.md b/docs/examples/index.md
@@ -15,6 +15,6 @@ meta-description: Navigate through CKEditor 5 examples to see what you are able
 
 ## Related links
 
- * {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 Builds.
- * {@link builds/guides/overview CKEditor 5 Builds} &ndash; Learn how to install, integrate and configure CKEditor 5 Builds. More complex aspects, like creating custom builds, are explained here, too.</dd>
+ * {@link features/index Features} &ndash; Learn about some of the features included in CKEditor 5 builds.
+ * {@link builds/guides/overview CKEditor 5 builds} &ndash; Learn how to install, integrate and configure CKEditor 5 builds. More complex aspects, like creating custom builds, are explained here, too.</dd>
  * {@link framework/guides/overview CKEditor 5 Framework} &ndash; Learn how to work with CKEditor 5 Framework, customize it, create your own plugins, custom editors, how to change the UI or even bring your own UI to the editor.
diff --git a/docs/features/index.md b/docs/features/index.md
@@ -96,7 +96,7 @@ If you want to migrate from CKEditor 4 to CKEditor 5, please check the {@link bu
 
 ## Feature availability
 
-Plenty of these features are included by default in the predefined {@link builds/guides/overview CKEditor 5 Builds} and are available out-of-the-box, like {@link features/autoformat autoformatting} or {@link features/keyboard-support keyboard support}.
+Plenty of these features are included by default in the predefined {@link builds/guides/overview CKEditor 5 builds} and are available out-of-the-box, like {@link features/autoformat autoformatting} or {@link features/keyboard-support keyboard support}.
 
 However, some of the presented features need to be manually included in a customized CKEditor 5 build, for example the {@link features/markdown Markdown processor} which outputs Markdown instead of HTML. These plugins can also be easily and conveniently added to a custom build with the [CKEditor 5 online builder](https://ckeditor.com/ckeditor-5/online-builder/).
 
diff --git a/docs/framework/guides/overview.md b/docs/framework/guides/overview.md
@@ -5,13 +5,13 @@ order: 10
 
 # Overview
 
-CKEditor 5 is a project that allows you to quickly and easily initialize one of the many types of editors it offers in your application. At the same time, it is a framework for creating custom-tailored rich-text editing solutions. The former requirement is met thanks to {@link builds/guides/overview CKEditor 5 Builds}. The latter &mdash; thanks to CKEditor 5 Framework.
+CKEditor 5 is a project that allows you to quickly and easily initialize one of the many types of editors it offers in your application. At the same time, it is a framework for creating custom-tailored rich-text editing solutions. The former requirement is met thanks to {@link builds/guides/overview CKEditor 5 builds}. The latter &mdash; thanks to CKEditor 5 Framework.
 
 This guide explains how the framework is built and how to start using it.
 
 ## When to use the framework?
 
-{@link builds/guides/development/custom-builds CKEditor 5 Builds can be customized}, but certain types of customizations require using the framework.
+{@link builds/guides/development/custom-builds CKEditor 5 builds can be customized}, but certain types of customizations require using the framework.
 
 * **Writing your own features.** Features are implemented using the framework.
 * **Customizing existing features.** Changing the behavior or look of existing features can be done using the framework capabilities.
@@ -47,7 +47,7 @@ There are a few groups of packages:
 * [Editors](https://github.com/ckeditor/ckeditor5#editors) &ndash; Packages that implement various types of editors.
 * [Features](https://github.com/ckeditor/ckeditor5#features) &ndash; Packages that implement end user features.
 * [Themes](https://github.com/ckeditor/ckeditor5#themes) &ndash; Packages that implement editor themes.
-* [Builds](https://github.com/ckeditor/ckeditor5#builds) &ndash; Packages containing {@link builds/guides/overview CKEditor 5 Builds}.
+* [Builds](https://github.com/ckeditor/ckeditor5#builds) &ndash; Packages containing {@link builds/guides/overview CKEditor 5 builds}.
 
 ## What's next?
 
diff --git a/docs/framework/guides/quick-start.md b/docs/framework/guides/quick-start.md
@@ -14,7 +14,7 @@ The CKEditor 5 Framework is made of several [npm packages](https://npmjs.com). T
 * [Node.js](https://nodejs.org/en/) 12.0.0+
 * npm 5.7.1+ (**note:** some npm 5+ versions were known to cause [problems](https://github.com/npm/npm/issues/16991), especially with deduplicating packages; upgrade npm when in doubt)
 
-Besides Node.js and npm you also need [webpack@4](https://webpack.js.org) with a few additional packages to use the framework. They are needed to bundle the source code. Read more about building CKEditor 5 in the {@link builds/guides/integration/advanced-setup CKEditor 5 Builds Advanced setup} guide.
+Besides Node.js and npm you also need [webpack@4](https://webpack.js.org) with a few additional packages to use the framework. They are needed to bundle the source code. Read more about building CKEditor 5 in the {@link builds/guides/integration/advanced-setup CKEditor 5 builds Advanced setup} guide.
 
 <!-- TODO replace the link above when the Framework will get its own building guide. -->
 
@@ -172,8 +172,8 @@ npm adds `./node_modules/.bin/` to the `PATH` automatically, so in this case you
 	Use `webpack --mode production` if you want to build a minified and optimized application. See more in the [webpack documentation](https://webpack.js.org/concepts/mode/).
 
 	**Note:** Prior to version 1.2.7, `uglifyjs-webpack-plugin` (the default minifier used by webpack) had a bug which caused webpack to crash with the following error: `TypeError: Assignment to constant variable.`. If you experienced this error, make sure that your `node_modules` contains an up-to-date version of this package (and that webpack uses this version).
-	
-	**Note:** CKEditor 5 Builds use [`Terser`](https://github.com/terser/terser) instead of `uglifyjs-webpack-plugin` because [the later one seems to be unsupported anymore](https://github.com/ckeditor/ckeditor5/issues/1353). 
+
+	**Note:** CKEditor 5 builds use [`Terser`](https://github.com/terser/terser) instead of `uglifyjs-webpack-plugin` because [the later one seems to be unsupported anymore](https://github.com/ckeditor/ckeditor5/issues/1353).
 </info-box>
 
 If everything worked correctly, you should see:
diff --git a/docs/framework/guides/support/license-and-legal.md b/docs/framework/guides/support/license-and-legal.md
@@ -18,7 +18,7 @@ Licensed under the terms of [GNU General Public License Version 2 or later](http
 
 Where not otherwise indicated, all CKEditor 5 Framework content is authored by CKSource engineers and consists of CKSource-owned intellectual property. In some specific instances, CKEditor will incorporate work done by developers outside of CKSource with their express permission.
 
-The {@link features/image-upload#easy-image Easy Image} feature present in {@link builds/index CKEditor 5 Builds} integrates with [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services), if configured to do so. CKEditor Cloud Services is an external "Software as a Service" solution, delivered with its own license terms and conditions.
+The {@link features/image-upload#easy-image Easy Image} feature present in {@link builds/index CKEditor 5 builds} integrates with [CKEditor Cloud Services](https://ckeditor.com/ckeditor-cloud-services), if configured to do so. CKEditor Cloud Services is an external "Software as a Service" solution, delivered with its own license terms and conditions.
 
 ## Trademarks
 
diff --git a/docs/index.md b/docs/index.md
@@ -11,7 +11,7 @@ meta-description: Learn how to install, integrate, update, configure and develop
 <dl><dt>{@link builds/index CKEditor 5 installation and update}</dt><dd>Learn how to install, integrate and configure CKEditor 5 from scratch or using predefined builds. More complex aspects, like creating custom builds or updating and migrating from an older version are explained here, too.</dd>
 <dt>{@link framework/guides/overview CKEditor 5 Framework}</dt><dd>Learn how to work with CKEditor 5 Framework, customize it, create your own plugins and custom editors, change the UI or even bring your own UI to the editor.</dd>
 <dt>{@link features/index CKEditor 5 Features}</dt><dd>Learn about the features available for CKEditor 5 &ndash; both the ones included in Builds and a plethora of others.</dd>
-<dt>{@link examples/index CKEditor 5 Examples}</dt><dd>Try out all CKEditor 5 Builds. See some of the possible customizations of CKEditor.</dd>
+<dt>{@link examples/index CKEditor 5 Examples}</dt><dd>Try out all CKEditor 5 builds. See some of the possible customizations of CKEditor.</dd>
 <dt>{@link api/index CKEditor 5 API Reference}</dt><dd>A complete API documentation.</dd></dl>
 
 ## Contribute
diff --git a/packages/ckeditor5-editor-balloon/README.md b/packages/ckeditor5-editor-balloon/README.md
@@ -9,7 +9,7 @@ The balloon editor implementation (Medium-like editor) for CKEditor 5.
 
 This package contains the [`BalloonEditor`](https://ckeditor.com/docs/ckeditor5/latest/api/module_editor-balloon_ballooneditor-BalloonEditor.html) class. Follow there to learn more about this type of editor and how to initialize it.
 
-This package contains the source version of the balloon editor. This editor implementation is also available in the [balloon build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon). Read more about [CKEditor 5 Builds](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html).
+This package contains the source version of the balloon editor. This editor implementation is also available in the [balloon build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon). Read more about [CKEditor 5 builds](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html).
 
 ## Documentation
 
diff --git a/packages/ckeditor5-editor-balloon/docs/api/editor-balloon.md b/packages/ckeditor5-editor-balloon/docs/api/editor-balloon.md
@@ -12,7 +12,7 @@ The balloon editor implementation (Medium-like editor) for CKEditor 5. See the {
 
 This package contains the {@link module:editor-balloon/ballooneditor~BalloonEditor} class. Follow there to learn more about this type of editor and how to initialize it.
 
-This package contains the source version of the balloon editor. This editor implementation is also available in the [balloon build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon). Read more about {@link builds/index CKEditor 5 Builds}.
+This package contains the source version of the balloon editor. This editor implementation is also available in the [balloon build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon). Read more about {@link builds/index CKEditor 5 builds}.
 
 ## Installation
 
diff --git a/packages/ckeditor5-editor-classic/README.md b/packages/ckeditor5-editor-classic/README.md
@@ -9,7 +9,7 @@ The classic editor implementation for CKEditor 5.
 
 This package contains the [`ClassicEditor`](https://ckeditor.com/docs/ckeditor5/latest/api/module_editor-classic_classiceditor-ClassicEditor.html) class. Follow there to learn more about this type of editor and how to initialize it.
 
-This package contains the source version of the classic editor. This editor implementation is also available in the [classic build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic). Read more about [CKEditor 5 Builds](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html).
+This package contains the source version of the classic editor. This editor implementation is also available in the [classic build](https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic). Read more about [CKEditor 5 builds](https://ckeditor.com/docs/ckeditor5/latest/builds/index.html).
 
 ## Documentation
 
diff --git a/packages/ckeditor5-editor-classic/docs/api/editor-classic.md b/packages/ckeditor5-editor-classic/docs/api/editor-classic.md
diff --git a/packages/ckeditor5-editor-decoupled/README.md b/packages/ckeditor5-editor-decoupled/README.md
diff --git a/packages/ckeditor5-editor-decoupled/docs/api/editor-decoupled.md b/packages/ckeditor5-editor-decoupled/docs/api/editor-decoupled.md
diff --git a/packages/ckeditor5-editor-inline/README.md b/packages/ckeditor5-editor-inline/README.md
diff --git a/packages/ckeditor5-editor-inline/docs/api/editor-inline.md b/packages/ckeditor5-editor-inline/docs/api/editor-inline.md
