Merge stable into master

ckeditor · Jan 9, 2023 · cb1d04c · cb1d04c
2 parents 1b95b17 + 55b999c
commit cb1d04c
Show file tree

Hide file tree

Showing 10 changed files with 92 additions and 82 deletions.
diff --git a/packages/ckeditor5-autoformat/docs/features/autoformat.md b/packages/ckeditor5-autoformat/docs/features/autoformat.md
@@ -79,11 +79,11 @@ import Autoformat from '@ckeditor/ckeditor5-autoformat/src/autoformat';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ Autoformat, ... ],
-		toolbar: [ ... ]
+		plugins: [ Autoformat, /* ... */ ],
+		toolbar: [ /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box hint>

diff --git a/packages/ckeditor5-basic-styles/docs/features/basic-styles.md b/packages/ckeditor5-basic-styles/docs/features/basic-styles.md
@@ -114,8 +114,8 @@ ClassicEditor
 			items: [ 'bold', 'italic', 'underline', 'strikethrough', 'code', 'subscript', 'superscript'  ]
 		}
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>

diff --git a/packages/ckeditor5-block-quote/docs/features/block-quote.md b/packages/ckeditor5-block-quote/docs/features/block-quote.md
@@ -64,11 +64,11 @@ import BlockQuote from '@ckeditor/ckeditor5-block-quote/src/blockquote';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ BlockQuote, ... ],
-		toolbar: [ 'blockQuote', ... ]
+		plugins: [ BlockQuote, /* ... */ ],
+		toolbar: [ 'blockQuote', /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>
@@ -99,9 +99,10 @@ ClassicEditor
 		extraPlugins: [ DisallowNestingBlockQuotes ],
 
 		// The rest of the configuration.
+		// ...
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box>

diff --git a/packages/ckeditor5-code-block/docs/features/code-blocks.md b/packages/ckeditor5-code-block/docs/features/code-blocks.md
@@ -56,8 +56,8 @@ ClassicEditor
 			]
 		}
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 {@snippet features/code-block-custom-languages}
@@ -84,8 +84,8 @@ ClassicEditor
 			]
 		}
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box>
@@ -150,11 +150,11 @@ import CodeBlock from '@ckeditor/ckeditor5-code-block/src/codeblock';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ CodeBlock, ... ],
-		toolbar: [ 'codeBlock', ... ]
+		plugins: [ CodeBlock, /* ... */ ],
+		toolbar: [ 'codeBlock', /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>

diff --git a/packages/ckeditor5-find-and-replace/docs/features/find-and-replace.md b/packages/ckeditor5-find-and-replace/docs/features/find-and-replace.md
@@ -41,11 +41,11 @@ import FindAndReplace from '@ckeditor/ckeditor5-find-and-replace/src/findandrepl
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ FindAndReplace, ... ],
-		toolbar: [ 'findAndReplace', ... ],
+		plugins: [ FindAndReplace, /* ... */ ],
+		toolbar: [ 'findAndReplace', /* ... */ ],
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>

diff --git a/packages/ckeditor5-font/docs/features/font.md b/packages/ckeditor5-font/docs/features/font.md
@@ -65,8 +65,8 @@ ClassicEditor
 			'heading', 'bulletedList', 'numberedList', 'fontFamily', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 {@snippet features/custom-font-family-options}
@@ -80,14 +80,16 @@ ClassicEditor
 	.create( document.querySelector( '#editor' ), {
 		fontFamily: {
 			options: [
+				// Font family configuration options are described in the "Configuring the font family feature" section.
 				// ...
 			],
 			supportAllValues: true
 		},
+		// More of editor's config.
         // ...
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 ## Configuring the font size feature
@@ -151,8 +153,8 @@ ClassicEditor
 			'heading', 'bulletedList', 'numberedList', 'fontSize', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 {@snippet features/custom-font-size-named-options}
@@ -187,8 +189,8 @@ ClassicEditor
 			'heading', 'bulletedList', 'numberedList', 'fontSize', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 {@snippet features/custom-font-size-numeric-options}
@@ -203,13 +205,15 @@ ClassicEditor
 		fontSize: {
 			options: [
 				// Numerical values.
+				// ...
 			],
 			supportAllValues: true
 		},
+		// More of editor's config.
         // ...
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>
@@ -258,7 +262,7 @@ ClassicEditor
 					label: 'White',
 					hasBorder: true
 				},
-
+				// More colors.
 				// ...
 			]
 		},
@@ -284,16 +288,16 @@ ClassicEditor
 					color: 'hsl(120, 75%, 60%)',
 					label: 'Green'
 				},
-
+				// More colors
 				// ...
 			]
 		},
 		toolbar: [
 			'heading', 'bulletedList', 'numberedList', 'fontColor', 'fontBackgroundColor', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 ### Changing the geometry of the color grid
@@ -307,24 +311,26 @@ ClassicEditor
 	.create( document.querySelector( '#editor' ), {
 		fontColor: {
 			colors: [
-				// 9 colors defined here...
+				// 9 colors defined here.
+				// ...
 			]
 
 			columns: 3, // so, you can display them in 3 columns.
 
+			// Optional configuration of the number of document colors.
 			// ...
 		},
 		fontBackgroundColor: {
 			columns: 6,
-
+			// Background color options.
 			// ...
 		},
 		toolbar: [
 			'heading', 'bulletedList', 'numberedList', 'fontColor', 'fontBackgroundColor', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 ### Documents colors
@@ -343,20 +349,22 @@ ClassicEditor
 			// And 12 document colors (2 rows of them).
 			documentColors: 12,
 
+			// Optional available font colors configuration.
 			// ...
 		},
 		fontBackgroundColor: {
 			// Remove the "Document colors" section.
 			documentColors: 0,
 
+			// Background color options.
 			// ...
 		},
 		toolbar: [
 			'heading', 'bulletedList', 'numberedList', 'fontColor', 'fontBackgroundColor', 'undo', 'redo'
 		]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 ## Installation
@@ -374,11 +382,11 @@ import Font from '@ckeditor/ckeditor5-font/src/font';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ Font, ... ],
-		toolbar: [ 'fontSize', 'fontFamily', 'fontColor', 'fontBackgroundColor', ... ]
+		plugins: [ Font, /* ... */ ],
+		toolbar: [ 'fontSize', 'fontFamily', 'fontColor', 'fontBackgroundColor', /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 You can also add just one or a selected few of the font features to your plugin list and the toolbar configuration:
@@ -388,11 +396,11 @@ import FontFamily from '@ckeditor/ckeditor5-font/src/fontfamily';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ FontFamily, ... ],
-		toolbar: [ 'fontFamily', ... ]
+		plugins: [ FontFamily, /* ... */ ],
+		toolbar: [ 'fontFamily', /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>

diff --git a/packages/ckeditor5-heading/docs/features/title.md b/packages/ckeditor5-heading/docs/features/title.md
@@ -35,14 +35,14 @@ To change the title placeholder, use the {@link module:heading/title~TitleConfig
 ```js
 ClassicEditor
     .create( document.querySelector( '#editor' ), {
-        plugins: [ Title, ... ],
+        plugins: [ Title, /* ... */ ],
         title: {
             placeholder: 'My custom placeholder for the title'
         },
         placeholder: 'My custom placeholder for the body'
     } )
-    .then( ... )
-    .catch( ... );
+    .then( /* ... */ )
+    .catch( /* ... */ );
 ```
 
 ## Installation
@@ -60,10 +60,10 @@ import Title from '@ckeditor/ckeditor5-heading/src/title';
 
 ClassicEditor
     .create( document.querySelector( '#editor' ), {
-        plugins: [ Title, ... ]
+        plugins: [ Title, /* ... */ ]
     } )
-    .then( ... )
-    .catch( ... );
+    .then( /* ... */ )
+    .catch( /* ... */ );
 ```
 
 <info-box info>

diff --git a/packages/ckeditor5-indent/docs/features/indent.md b/packages/ckeditor5-indent/docs/features/indent.md
@@ -52,7 +52,7 @@ import Indent from '@ckeditor/ckeditor5-indent/src/indent';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ Indent, ... ],
+		plugins: [ Indent, /* ... */ ],
 		toolbar: {
 			items: [ 'heading', '|', 'outdent', 'indent', '|', 'bulletedList', 'numberedList', '|', 'undo', 'redo' ]
 		},
@@ -61,8 +61,8 @@ ClassicEditor
 			unit: 'em'
 		}
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 ### Using CSS classes
@@ -77,7 +77,7 @@ import IndentBlock from '@ckeditor/ckeditor5-indent/src/indentblock';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ Indent, IndentBlock, ... ],
+		plugins: [ Indent, IndentBlock, /* ... */ ],
 		toolbar: {
 			items: [ 'heading', '|', 'outdent', 'indent', '|', 'bulletedList', 'numberedList', '|', 'undo', 'redo' ]
 		},
@@ -89,8 +89,8 @@ ClassicEditor
 			]
 		}
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 Using classes instead of fixed units (`px` or `em`) has another advantage &mdash; you retain control over what indentation levels are used in the documents. For instance, you can limit indentation to 2 or 3 different levels and there is no way the users can go beyond that. In the example above, the `.custom-block-indent-c` class level is the maximum allowed indentation value. This should help keep your content clean and predictable.
@@ -148,11 +148,11 @@ import IndentBlock from '@ckeditor/ckeditor5-indent/src/indentblock';
 
 ClassicEditor
 	.create( document.querySelector( '#editor' ), {
-		plugins: [ Indent, IndentBlock, ... ],
-		toolbar: [ 'outdent', 'indent', ... ]
+		plugins: [ Indent, IndentBlock, /* ... */ ],
+		toolbar: [ 'outdent', 'indent', /* ... */ ]
 	} )
-	.then( ... )
-	.catch( ... );
+	.then( /* ... */ )
+	.catch( /* ... */ );
 ```
 
 <info-box info>