8
0
Просмотр исходного кода

Merge branch 'master' into i/6175

Marek Lewandowski 6 лет назад
Родитель
Сommit
4fce26d8f9
20 измененных файлов с 200 добавлено и 88 удалено
  1. 51 6
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-extended-category.html
  2. 0 2
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-extended-category.js
  3. 44 6
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-limited-categories.html
  4. 0 2
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-limited-categories.js
  5. 2 6
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-new-category.html
  6. 2 4
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-new-category.js
  7. 1 1
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-source.js
  8. 44 6
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters.html
  9. 0 2
      packages/ckeditor5-special-characters/docs/_snippets/features/special-characters.js
  10. 24 22
      packages/ckeditor5-special-characters/docs/features/special-characters.md
  11. 10 9
      packages/ckeditor5-special-characters/src/specialcharacters.js
  12. 1 1
      packages/ckeditor5-special-characters/src/specialcharactersarrows.js
  13. 1 1
      packages/ckeditor5-special-characters/src/specialcharacterscurrency.js
  14. 1 1
      packages/ckeditor5-special-characters/src/specialcharactersessentials.js
  15. 1 1
      packages/ckeditor5-special-characters/src/specialcharacterslatin.js
  16. 1 1
      packages/ckeditor5-special-characters/src/specialcharactersmathematical.js
  17. 1 1
      packages/ckeditor5-special-characters/src/specialcharacterstext.js
  18. 9 9
      packages/ckeditor5-special-characters/src/ui/charactergridview.js
  19. 2 2
      packages/ckeditor5-special-characters/src/ui/characterinfoview.js
  20. 5 5
      packages/ckeditor5-special-characters/src/ui/specialcharactersnavigationview.js

+ 51 - 6
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-extended-category.html

@@ -1,10 +1,55 @@
 <div id="snippet-special-characters-extended-category">
-	<h2 style="text-align:center;">The Flavorful Tuscany Meetup</h2>
-	<h3 style="text-align:center;">Welcome letter</h3>
-	<p>Dear Guest,</p>
-	<p>We are delighted to welcome you to the annual <i>Flavorful Tuscany Meetup</i> and hope you will enjoy the programme as well as your stay at the <a href="https://ckeditor.com">Bilancino Hotel</a>.</p>
-	<p>Please arrive at the <a href="https://ckeditor.com">Bilancino Hotel</a> reception desk at least half an hour earlier to make sure that the registration process goes as smoothly as possible.</p>
-	<p>We look forward to welcoming you to the event. The full schedule can be found below.</p>
+	<h3>Euro foreign exchange reference rates</h3>
+	<p>As of February 10, 2020</p>
+	<p>All currencies quoted against the euro (€) as base currency.</p>
+	<table>
+		<thead>
+			<tr>
+				<th scope="col">Currency name</th>
+				<th scope="col">Symbol</th>
+				<th scope="col">Spot</th>
+				<th scope="col">Change</th>
+			</tr>
+		</thead>
+		<tbody>
+			<tr>
+				<td>US Dollar</td>
+				<td>$</td>
+				<td>1.0951</td>
+				<td>↓</td>
+			</tr>
+			<tr>
+				<td>British Pound</td>
+				<td>£</td>
+				<td>0.8463</td>
+				<td>↓</td>
+			</tr>
+			<tr>
+				<td>Indian Rupee</td>
+				<td>₹</td>
+				<td>78.1070</td>
+				<td>↓</td>
+			</tr>
+			<tr>
+				<td>Japanese Yen</td>
+				<td>¥</td>
+				<td>120.1800</td>
+				<td>↓</td>
+			</tr>
+			<tr>
+				<td>Russian Ruble</td>
+				<td>₽</td>
+				<td>70.1120</td>
+				<td>↑</td>
+			</tr>
+			<tr>
+				<td>Turkish Lira</td>
+				<td>₺</td>
+				<td>6.5897</td>
+				<td>↑</td>
+			</tr>
+		</tbody>
+	</table>
 </div>
 
 <style>

+ 0 - 2
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-extended-category.js

@@ -32,10 +32,8 @@ ClassicEditor
 				'indent',
 				'|',
 				'specialCharacters',
-				'blockQuote',
 				'link',
 				'imageUpload',
-				'mediaEmbed',
 				'insertTable',
 				'|',
 				'undo',

+ 44 - 6
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-limited-categories.html

@@ -1,10 +1,48 @@
 <div id="snippet-special-characters-limited-categories">
-	<h2 style="text-align:center;">The Flavorful Tuscany Meetup</h2>
-	<h3 style="text-align:center;">Welcome letter</h3>
-	<p>Dear Guest,</p>
-	<p>We are delighted to welcome you to the annual <i>Flavorful Tuscany Meetup</i> and hope you will enjoy the programme as well as your stay at the <a href="https://ckeditor.com">Bilancino Hotel</a>.</p>
-	<p>Please arrive at the <a href="https://ckeditor.com">Bilancino Hotel</a> reception desk at least half an hour earlier to make sure that the registration process goes as smoothly as possible.</p>
-	<p>We look forward to welcoming you to the event. The full schedule can be found below.</p>
+	<h3>Euro foreign exchange reference rates</h3>
+	<p>As of February 10, 2020</p>
+	<p>All currencies quoted against the euro (€) as base currency.</p>
+	<table>
+		<thead>
+			<tr>
+				<th scope="col">Currency name</th>
+				<th scope="col">Symbol</th>
+				<th scope="col">Spot</th>
+			</tr>
+		</thead>
+		<tbody>
+			<tr>
+				<td>US Dollar</td>
+				<td>$</td>
+				<td>1.0951</td>
+			</tr>
+			<tr>
+				<td>British Pound</td>
+				<td>£</td>
+				<td>0.8463</td>
+			</tr>
+			<tr>
+				<td>Indian Rupee</td>
+				<td>₹</td>
+				<td>78.1070</td>
+			</tr>
+			<tr>
+				<td>Japanese Yen</td>
+				<td>¥</td>
+				<td>120.1800</td>
+			</tr>
+			<tr>
+				<td>Russian Ruble</td>
+				<td>₽</td>
+				<td>70.1120</td>
+			</tr>
+			<tr>
+				<td>Turkish Lira</td>
+				<td>₺</td>
+				<td>6.5897</td>
+			</tr>
+		</tbody>
+	</table>
 </div>
 
 <style>

+ 0 - 2
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-limited-categories.js

@@ -23,10 +23,8 @@ ClassicEditor
 				'indent',
 				'|',
 				'specialCharacters',
-				'blockQuote',
 				'link',
 				'imageUpload',
-				'mediaEmbed',
 				'insertTable',
 				'|',
 				'undo',

+ 2 - 6
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-new-category.html

@@ -1,10 +1,6 @@
 <div id="snippet-special-characters-new-category">
-	<h2 style="text-align:center;">The Flavorful Tuscany Meetup</h2>
-	<h3 style="text-align:center;">Welcome letter</h3>
-	<p>Dear Guest,</p>
-	<p>We are delighted to welcome you to the annual <i>Flavorful Tuscany Meetup</i> and hope you will enjoy the programme as well as your stay at the <a href="https://ckeditor.com">Bilancino Hotel</a>.</p>
-	<p>Please arrive at the <a href="https://ckeditor.com">Bilancino Hotel</a> reception desk at least half an hour earlier to make sure that the registration process goes as smoothly as possible.</p>
-	<p>We look forward to welcoming you to the event. The full schedule can be found below.</p>
+	<p>Build your CKEditor 5 in a breeze. 🌬 Choose an editor type and customize plugins, toolbar and language in 5 simple steps. 😊</p>
+	<p>The new <a href="https://ckeditor.com/ckeditor-5/online-builder/">CKEditor 5 online builder</a> is finally here! 🚀</p>
 </div>
 
 <style>

+ 2 - 4
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-new-category.js

@@ -11,9 +11,9 @@ function SpecialCharactersEmoji( editor ) {
 	editor.plugins.get( 'SpecialCharacters' ).addItems( 'Emoji', [
 		{ title: 'smiley face', character: '😊' },
 		{ title: 'rocket', character: '🚀' },
-		{ title: 'basketball', character: '🏀' },
+		{ title: 'wind blowing face', character: '🌬️' },
 		{ title: 'floppy disk', character: '💾' },
-		{ title: 'hearth', character: '❤' }
+		{ title: 'heart', character: '❤' }
 	] );
 }
 
@@ -33,10 +33,8 @@ ClassicEditor
 				'indent',
 				'|',
 				'specialCharacters',
-				'blockQuote',
 				'link',
 				'imageUpload',
-				'mediaEmbed',
 				'insertTable',
 				'|',
 				'undo',

+ 1 - 1
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters-source.js

@@ -9,7 +9,7 @@ import ClassicEditor from '@ckeditor/ckeditor5-build-classic/src/ckeditor';
 import SpecialCharacters from '@ckeditor/ckeditor5-special-characters/src/specialcharacters';
 import SpecialCharactersEssentials from '@ckeditor/ckeditor5-special-characters/src/specialcharactersessentials';
 import SpecialCharactersCurrency from '@ckeditor/ckeditor5-special-characters/src/specialcharacterscurrency';
-import SpecialCharactersMathematical from '@ckeditor/ckeditor5-special-characters/src/SpecialCharactersMathematical';
+import SpecialCharactersMathematical from '@ckeditor/ckeditor5-special-characters/src/specialcharactersmathematical';
 
 ClassicEditor.builtinPlugins.push( SpecialCharacters );
 

+ 44 - 6
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters.html

@@ -1,10 +1,48 @@
 <div id="snippet-special-characters">
-	<h2 style="text-align:center;">The Flavorful Tuscany Meetup</h2>
-	<h3 style="text-align:center;">Welcome letter</h3>
-	<p>Dear Guest,</p>
-	<p>We are delighted to welcome you to the annual <i>Flavorful Tuscany Meetup</i> and hope you will enjoy the programme as well as your stay at the <a href="https://ckeditor.com">Bilancino Hotel</a>.</p>
-	<p>Please arrive at the <a href="https://ckeditor.com">Bilancino Hotel</a> reception desk at least half an hour earlier to make sure that the registration process goes as smoothly as possible.</p>
-	<p>We look forward to welcoming you to the event. The full schedule can be found below.</p>
+	<h3>Euro foreign exchange reference rates</h3>
+	<p>As of February 10, 2020</p>
+	<p>All currencies quoted against the euro (€) as base currency.</p>
+	<table>
+		<thead>
+			<tr>
+				<th scope="col">Currency name</th>
+				<th scope="col">Symbol</th>
+				<th scope="col">Spot</th>
+			</tr>
+		</thead>
+		<tbody>
+			<tr>
+				<td>US Dollar</td>
+				<td>$</td>
+				<td>1.0951</td>
+			</tr>
+			<tr>
+				<td>British Pound</td>
+				<td>£</td>
+				<td>0.8463</td>
+			</tr>
+			<tr>
+				<td>Indian Rupee</td>
+				<td>₹</td>
+				<td>78.1070</td>
+			</tr>
+			<tr>
+				<td>Japanese Yen</td>
+				<td>¥</td>
+				<td>120.1800</td>
+			</tr>
+			<tr>
+				<td>Russian Ruble</td>
+				<td>₽</td>
+				<td>70.1120</td>
+			</tr>
+			<tr>
+				<td>Turkish Lira</td>
+				<td>₺</td>
+				<td>6.5897</td>
+			</tr>
+		</tbody>
+	</table>
 </div>
 
 <style>

+ 0 - 2
packages/ckeditor5-special-characters/docs/_snippets/features/special-characters.js

@@ -23,10 +23,8 @@ ClassicEditor
 				'indent',
 				'|',
 				'specialCharacters',
-				'blockQuote',
 				'link',
 				'imageUpload',
-				'mediaEmbed',
 				'insertTable',
 				'|',
 				'undo',

+ 24 - 22
packages/ckeditor5-special-characters/docs/features/special-characters.md

@@ -9,7 +9,7 @@ The {@link module:special-characters/specialcharacters~SpecialCharacters} plugin
 
 ## Demo
 
-Use the editor below to see the {@link module:special-characters/specialcharacters~SpecialCharacters} plugin in action.
+Use the editor below to see the special characters plugin in action.
 
 {@snippet features/special-characters-source}
 
@@ -17,11 +17,13 @@ Use the editor below to see the {@link module:special-characters/specialcharacte
 
 ## Configuration
 
+By default, a few categories of special characters have been defined. You can easily customize the special characters available in your WYSIWYG editor installation by adding new categories, extending the existing ones or removing them altogether.
+
 ### Adding a new category
 
 You can define a new special characters category using the {@link module:special-characters/specialcharacters~SpecialCharacters#addItems `SpecialCharacters#addItems()`} function.
 
-For example, the following plugin adds the "Emoji" category in the special characters dropdown.
+For example, the following plugin adds the "Emoji" category to the special characters dropdown.
 
 ```js
 import SpecialCharacters from '@ckeditor/ckeditor5-special-characters/src/specialcharacters';
@@ -31,9 +33,9 @@ function SpecialCharactersEmoji( editor ) {
 	editor.plugins.get( 'SpecialCharacters' ).addItems( 'Emoji', [
 		{ title: 'smiley face', character: '😊' },
 		{ title: 'rocket', character: '🚀' },
-		{ title: 'basketball', character: '🏀' },
+		{ title: 'wind blowing face', character: '🌬️' },
 		{ title: 'floppy disk', character: '💾' },
-		{ title: 'hearth', character: '❤' }
+		{ title: 'heart', character: '❤' }
 	] );
 }
 
@@ -50,19 +52,19 @@ ClassicEditor
 	.catch( ... );
 ```
 
-After adding the above plugin into the editor, the new category will be available in the special characters dropdown.
+After adding the above plugin to the editor configuration, the new category will become available in the special characters dropdown.
 
 <info-box>
-	A title of a special character must be unique across the entire special characters set.
+	The title of a special character must be unique across the entire special characters set.
 </info-box>
 
-Below, you can see a demo based on the example shown above. Use the special characters icon in the editor's toolbar then select "Emoji" in the select dropdown in order to insert a emoji into the editor.
+Below you can see a demo based on the example shown above. Use the special characters icon in the editor toolbar and then select "Emoji" in the select dropdown in order to insert an emoji into the WYSIWYG editor.
 
 {@snippet features/special-characters-new-category}
 
 ### Adding characters to an existing category
 
-By using the {@link module:special-characters/specialcharacters~SpecialCharacters#addItems `SpecialCharacters#addItems()`} function, you can also add new special characters into existing category.
+By using the {@link module:special-characters/specialcharacters~SpecialCharacters#addItems `SpecialCharacters#addItems()`} function you can also add new special characters into an existing category.
 
 ```js
 import SpecialCharacters from '@ckeditor/ckeditor5-special-characters/src/specialcharacters';
@@ -91,27 +93,27 @@ ClassicEditor
 ```
 
 <info-box>
-	A title of a special character must be unique across the entire special characters set.
+	The title of a special character must be unique across the entire special characters set.
 </info-box>
 
-Below, you can see a demo based on the example shown above. Use the special characters icon in the editor's toolbar then select "Arrows" in the select dropdown. You'll see that it contains more arrows than the other instances.
+Below, you can see a demo based on the example shown above. Use the special characters icon in the editor toolbar and then select "Arrows" in the select dropdown. You will see that the category now contains the additional arrow characters added in the configuration above.
 
 {@snippet features/special-characters-extended-category}
 
 ### Removing categories
 
-The special characters feature exposes each category as a separate plugin. While the {@link module:special-characters/specialcharactersessentials~SpecialCharactersEssentials} plugin can be used to conveniently include all of them, you can customize the category list by adding individual plugins.
+The special characters feature exposes each category as a separate plugin. While the {@link module:special-characters/specialcharactersessentials~SpecialCharactersEssentials} plugin can be used to conveniently include all of them, you can customize the category list by adding individual plugins with particular categories.
 
-The `@ckeditor/ckeditor5-special-characters` package provides special characters grouped into the following categories:
+By default, the `@ckeditor/ckeditor5-special-characters` package provides special characters grouped into the following categories:
 
-* {@link module:special-characters/specialcharactersarrows~SpecialCharactersArrows} – arrows special characters,
-* {@link module:special-characters/specialcharacterscurrency~SpecialCharactersCurrency} - currency special characters,
-* {@link module:special-characters/specialcharacterslatin~SpecialCharactersLatin} – Latin special characters,
-* {@link module:special-characters/specialcharactersmathematical~SpecialCharactersMathematical} – mathematical special characters,
-* {@link module:special-characters/specialcharacterstext~SpecialCharactersText} – text special characters,
-* {@link module:special-characters/specialcharactersessentials~SpecialCharactersEssentials} – combining plugins listed above.
+* {@link module:special-characters/specialcharactersarrows~SpecialCharactersArrows} &ndash; Arrows special characters.
+* {@link module:special-characters/specialcharacterscurrency~SpecialCharactersCurrency} &ndash; Currency special characters.
+* {@link module:special-characters/specialcharacterslatin~SpecialCharactersLatin} &ndash; Latin special characters.
+* {@link module:special-characters/specialcharactersmathematical~SpecialCharactersMathematical} &ndash; Mathematical special characters.
+* {@link module:special-characters/specialcharacterstext~SpecialCharactersText} &ndash; Text special characters.
+* {@link module:special-characters/specialcharactersessentials~SpecialCharactersEssentials} &ndash; Combines the plugins listed above.
 
-For example, you can limit categories to "Mathematical" and "Currency" only by picking the {@link module:special-characters/specialcharactersmathematical~SpecialCharactersMathematical} and {@link module:special-characters/specialcharacterscurrency~SpecialCharactersCurrency} plugins, like so:
+For example, you can limit the categories to "Mathematical" and "Currency" only by picking the {@link module:special-characters/specialcharactersmathematical~SpecialCharactersMathematical} and {@link module:special-characters/specialcharacterscurrency~SpecialCharactersCurrency} plugins, like so:
 
 ```js
 import SpecialCharacters from '@ckeditor/ckeditor5-special-characters/src/specialcharacters';
@@ -131,7 +133,7 @@ ClassicEditor
 	.catch( ... );
 ```
 
-Below, you can see a demo based on the example shown above. After clicking the special character icon in the editor's toolbar you can see that it contains fewer categories compared to other editors on this page.
+Below, you can see a demo based on the example shown above. After clicking the special character icon in the editor toolbar you can see that it contains fewer categories compared to other editors on this page.
 
 {@snippet features/special-characters-limited-categories}
 
@@ -146,9 +148,9 @@ npm install --save @ckeditor/ckeditor5-special-characters
 And add it to your plugin list configuration:
 
 ```js
-// Core plugin that provides the API for management special characters and their categories.
+// Core plugin that provides the API for the management of special characters and their categories.
 import SpecialCharacters from '@ckeditor/ckeditor5-special-characters/src/specialcharacters';
-// Plugin that combines the basic set of special characters.
+// A plugin that combines a basic set of special characters.
 import SpecialCharactersEssentials from '@ckeditor/ckeditor5-special-characters/src/specialcharactersessentials';
 
 ClassicEditor

+ 10 - 9
packages/ckeditor5-special-characters/src/specialcharacters.js

@@ -113,9 +113,9 @@ export default class SpecialCharacters extends Plugin {
 	}
 
 	/**
-	 * Adds a collection of special characters to specified group. A title of a special character must be unique.
+	 * Adds a collection of special characters to the specified group. The title of a special character must be unique.
 	 *
-	 * **Note:** The "All" category name is reserved by the plugin and cannot be used as a new name for special
+	 * **Note:** The "All" category name is reserved by the plugin and cannot be used as a new name for a special
 	 * characters category.
 	 *
 	 * @param {String} groupName
@@ -124,8 +124,8 @@ export default class SpecialCharacters extends Plugin {
 	addItems( groupName, items ) {
 		if ( groupName === ALL_SPECIAL_CHARACTERS_GROUP ) {
 			/**
-			 * The name "All" for special category group cannot be used because it's a special category which displays all available
-			 * special characters.
+			 * The name "All" for a special category group cannot be used because it is a special category that displays all
+			 * available special characters.
 			 *
 			 * @error special-character-invalid-group-name
 			 */
@@ -143,7 +143,7 @@ export default class SpecialCharacters extends Plugin {
 	}
 
 	/**
-	 * Returns iterator of special characters groups.
+	 * Returns an iterator of special characters groups.
 	 *
 	 * @returns {Iterable.<String>}
 	 */
@@ -166,9 +166,10 @@ export default class SpecialCharacters extends Plugin {
 	}
 
 	/**
-	 * Returns a symbol of the special character for specified name. If the special character couldn't be found, `undefined` is returned.
+	 * Returns the symbol of a special character for the specified name. If the special character could not be found, `undefined`
+	 * is returned.
 	 *
-	 * @param {String} title A title of the special character.
+	 * @param {String} title The title of a special character.
 	 * @returns {String|undefined}
 	 */
 	getCharacter( title ) {
@@ -179,7 +180,7 @@ export default class SpecialCharacters extends Plugin {
 	 * Returns a group of special characters. If the group with the specified name does not exist, it will be created.
 	 *
 	 * @private
-	 * @param {String} groupName A name of group to create.
+	 * @param {String} groupName The name of the group to create.
 	 */
 	_getGroup( groupName ) {
 		if ( !this._groups.has( groupName ) ) {
@@ -249,5 +250,5 @@ export default class SpecialCharacters extends Plugin {
  * @typedef {Object} module:special-characters/specialcharacters~SpecialCharacterDefinition
  *
  * @property {String} title A unique name of the character (e.g. "greek small letter epsilon").
- * @property {String} character A human-readable character displayed as label (e.g. "ε").
+ * @property {String} character A human-readable character displayed as the label (e.g. "ε").
  */

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharactersarrows.js

@@ -10,7 +10,7 @@
 import Plugin from '@ckeditor/ckeditor5-core/src/plugin';
 
 /**
- * A plugin provides special characters for the "Arrows" category.
+ * A plugin that provides special characters for the "Arrows" category.
  *
  *		ClassicEditor
  *			.create( {

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharacterscurrency.js

@@ -10,7 +10,7 @@
 import Plugin from '@ckeditor/ckeditor5-core/src/plugin';
 
 /**
- * A plugin provides special characters for the "Currency" category.
+ * A plugin that provides special characters for the "Currency" category.
  *
  *		ClassicEditor
  *			.create( {

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharactersessentials.js

@@ -16,7 +16,7 @@ import SpecialCharactersLatin from './specialcharacterslatin';
 import SpecialCharactersText from './specialcharacterstext';
 
 /**
- * A plugin combining basic set of characters for the special characters plugin.
+ * A plugin combining a basic set of characters for the special characters plugin.
  *
  *		ClassicEditor
  *			.create( {

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharacterslatin.js

@@ -10,7 +10,7 @@
 import Plugin from '@ckeditor/ckeditor5-core/src/plugin';
 
 /**
- * A plugin provides special characters for the "Latin" category.
+ * A plugin that provides special characters for the "Latin" category.
  *
  *		ClassicEditor
  *			.create( {

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharactersmathematical.js

@@ -10,7 +10,7 @@
 import Plugin from '@ckeditor/ckeditor5-core/src/plugin';
 
 /**
- * A plugin provides special characters for the "Mathematical" category.
+ * A plugin that provides special characters for the "Mathematical" category.
  *
  *		ClassicEditor
  *			.create( {

+ 1 - 1
packages/ckeditor5-special-characters/src/specialcharacterstext.js

@@ -10,7 +10,7 @@
 import Plugin from '@ckeditor/ckeditor5-core/src/plugin';
 
 /**
- * A plugin provides special characters for the "Text" category.
+ * A plugin that provides special characters for the "Text" category.
  *
  *		ClassicEditor
  *			.create( {

+ 9 - 9
packages/ckeditor5-special-characters/src/ui/charactergridview.js

@@ -13,7 +13,7 @@ import ButtonView from '@ckeditor/ckeditor5-ui/src/button/buttonview';
 import '../../theme/charactergrid.css';
 
 /**
- * A grid of character tiles. Allows browsing special characters and selecting the character to
+ * A grid of character tiles. It allows browsing special characters and selecting the character to
  * be inserted into the content.
  *
  * @extends module:ui/view~View
@@ -28,7 +28,7 @@ export default class CharacterGridView extends View {
 		super( locale );
 
 		/**
-		 * Collection of the child tile views. Each tile represents some particular character.
+		 * A collection of the child tile views. Each tile represents a particular character.
 		 *
 		 * @readonly
 		 * @member {module:ui/viewcollection~ViewCollection}
@@ -62,26 +62,26 @@ export default class CharacterGridView extends View {
 		 *
 		 * @event execute
 		 * @param {Object} data Additional information about the event.
-		 * @param {String} data.name A name of the tile that caused the event (e.g. "greek small letter epsilon").
-		 * @param {String} data.character A human-readable character displayed as label (e.g. "ε").
+		 * @param {String} data.name The name of the tile that caused the event (e.g. "greek small letter epsilon").
+		 * @param {String} data.character A human-readable character displayed as the label (e.g. "ε").
 		 */
 
 		/**
-		 * Fired when a mouse or other pointing device caused the cursor to move onto any {@link #tiles grid tile}
+		 * Fired when a mouse or another pointing device caused the cursor to move onto any {@link #tiles grid tile}
 		 * (similar to the native `mouseover` DOM event).
 		 *
 		 * @event tileHover
 		 * @param {Object} data Additional information about the event.
-		 * @param {String} data.name A name of the tile that caused the event (e.g. "greek small letter epsilon").
-		 * @param {String} data.character A human-readable character displayed as label (e.g. "ε").
+		 * @param {String} data.name The name of the tile that caused the event (e.g. "greek small letter epsilon").
+		 * @param {String} data.character A human-readable character displayed as the label (e.g. "ε").
 		 */
 	}
 
 	/**
 	 * Creates a new tile for the grid.
 	 *
-	 * @param {String} character A human-readable character displayed as label (e.g. "ε").
-	 * @param {String} name A name of the character (e.g. "greek small letter epsilon").
+	 * @param {String} character A human-readable character displayed as the label (e.g. "ε").
+	 * @param {String} name The name of the character (e.g. "greek small letter epsilon").
 	 * @returns {module:ui/button/buttonview~ButtonView}
 	 */
 	createTile( character, name ) {

+ 2 - 2
packages/ckeditor5-special-characters/src/ui/characterinfoview.js

@@ -24,7 +24,7 @@ export default class CharacterInfoView extends View {
 		const bind = this.bindTemplate;
 
 		/**
-		 * The character which info is displayed by the view. For instance,
+		 * The character whose information is displayed by the view. For instance,
 		 * "∑" or "¿".
 		 *
 		 * @observable
@@ -96,7 +96,7 @@ export default class CharacterInfoView extends View {
 //
 //	"$" -> "U+0024"
 //
-// Returns empty string when character is `null`.
+// Returns an empty string when the character is `null`.
 //
 // @param {String} character
 // @returns {String}

+ 5 - 5
packages/ckeditor5-special-characters/src/ui/specialcharactersnavigationview.js

@@ -28,7 +28,7 @@ export default class SpecialCharactersNavigationView extends View {
 	 * class.
 	 *
 	 * @param {module:utils/locale~Locale} locale The localization services instance.
-	 * @param {Iterable.<String>} groupNames Names of the character groups.
+	 * @param {Iterable.<String>} groupNames The names of the character groups.
 	 */
 	constructor( locale, groupNames ) {
 		super( locale );
@@ -36,7 +36,7 @@ export default class SpecialCharactersNavigationView extends View {
 		const t = locale.t;
 
 		/**
-		 * Label of the navigation view describing its purpose.
+		 * The label of the navigation view describing its purpose.
 		 *
 		 * @member {module:ui/label/labelview~LabelView}
 		 */
@@ -67,7 +67,7 @@ export default class SpecialCharactersNavigationView extends View {
 	}
 
 	/**
-	 * Returns a name of the character group currently selected in the {@link #groupDropdownView}.
+	 * Returns the name of the character group currently selected in the {@link #groupDropdownView}.
 	 *
 	 * @returns {String}
 	 */
@@ -79,7 +79,7 @@ export default class SpecialCharactersNavigationView extends View {
 	 * Returns a dropdown that allows selecting character groups.
 	 *
 	 * @private
-	 * @param {Iterable.<String>} groupNames Names of the character groups.
+	 * @param {Iterable.<String>} groupNames The names of the character groups.
 	 * @returns {module:ui/dropdown/dropdownview~DropdownView}
 	 */
 	_createGroupDropdown( groupNames ) {
@@ -115,7 +115,7 @@ export default class SpecialCharactersNavigationView extends View {
 	 *
 	 * @private
 	 * @param {module:ui/dropdown/dropdownview~DropdownView} dropdown
-	 * @param {Iterable.<String>} groupNames Names of the character groups.
+	 * @param {Iterable.<String>} groupNames The names of the character groups.
 	 * @returns {Iterable.<module:ui/dropdown/utils~ListDropdownItemDefinition>}
 	 */
 	_getCharacterGroupListItemDefinitions( dropdown, groupNames ) {