Sfoglia il codice sorgente

Docs: Introductory articles in Builds revised.

Anna Tomanek 8 anni fa
parent
commit
0a90c9a252

+ 18 - 18
docs/builds/guides/overview.md

@@ -10,7 +10,7 @@ category: builds-guides
 order: 10
 ---
 
-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 easy to use solutions that can be installed with no effort and that satisfy the most common editing use cases.
+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
 
@@ -24,13 +24,13 @@ The following CKEditor 5 Builds are currently available:
 
 Classic editor is what most users traditionally learnt to associate with a rich text editor — a toolbar with an editing area placed in a specific position on the page, usually as a part of a form that you use to submit some content to the server.
 
-The editor during initialisation hides given element on a page and renders "instead" of it, that's why it's usually used to replace `<textarea>` elements.
+During its initialisation the editor hides the used editable element on the page and renders "instead" of it. This is why it is usually used to replace `<textarea>` elements.
 
 In CKEditor 5 the concept of the "boxed" editor was reinvented:
 
- * The toolbar is now always visible when user scrolls the page down.
- * The editor content is now placed inline in the page (without surrounding `<iframe>` element) — it is now much easier to style it.
- * The editor now grows automatically with the content by default.
+ * The toolbar is now always visible when the user scrolls the page down.
+ * The editor content is now placed inline in the page (without the surrounding `<iframe>` element) &mdash; it is now much easier to style it.
+ * By default the editor now grows automatically with the content.
 
 {@img assets/img/editor-classic.png 772 Screenshot of a classic editor.}
 
@@ -38,9 +38,9 @@ To try it out online, check the {@link examples/builds/classic-editor classic ed
 
 ### Inline editor
 
-Inline editor comes with a floating toolbar, which becomes visible when the editor is focused (e.g. by clicking on it). Unlike classic editor, inline editor does not render "instead" of a given element, it simply makes it editable. As a consequence the styles of the edited content will be exactly the same before and after the editor is created.
+Inline editor comes with a floating toolbar that becomes visible when the editor is focused (e.g. by clicking it). Unlike classic editor, inline editor does not render *instead* of the given element, it simply makes it editable. As a consequence the styles of the edited content will be exactly the same before and after the editor is created.
 
-A common scenario for using inline editor is offering users the possibility to edit content in its real location in a web page, instead of doing it in a separate administration section.  
+A common scenario for using inline editor is offering users the possibility to edit content in its real location on a web page instead of doing it in a separate administration section.  
 
 {@img assets/img/editor-inline.png 774 Screenshot of an inline editor.}
 
@@ -48,15 +48,15 @@ To try it out online, check the {@link examples/builds/inline-editor inline edit
 
 ### Balloon toolbar editor
 
-Balloon toolbar editor is very similar to the inline editor. The difference between them is that the toolbar appears in a balloon next to the selection (when the selection is not empty):
+Balloon toolbar editor is very similar to inline editor. The difference between them is that the toolbar appears in a balloon next to the selection (when the selection is not empty):
 
 {@img assets/img/editor-balloon-toolbar.png 779 Screenshot of a baloon toolbar editor.}
 
 To try it out online, check the {@link examples/builds/balloon-toolbar-editor balloon toolbar editor example}. Jump to {@link builds/guides/quick-start#Balloon-toolbar-editor quick start} to start using it.
 
-## Builds customization
+## Build customization
 
-Every build comes with a default set of features and a default configuration of them. Although the builds try to fit many cases, they may still need to be adjusted in some integrations. The following modifications are possible:
+Every build comes with a default set of features and their default configuration. Although the builds try to fit many use cases, they may still need to be adjusted in some integrations. The following modifications are possible:
 
  * You can override the default **configuration of features** (e.g. define different image styles or heading levels).
  * You can change the default **toolbar configuration** (e.g. remove undo/redo buttons).
@@ -64,7 +64,7 @@ Every build comes with a default set of features and a default configuration of
 
 Read more in the {@link builds/guides/integration/configuration Configuration guide}.
 
-If a build doesn't provide all the necessary features or you want create a highly optimized build of editor which will contain only the necessary features, then you need to customize the build or create a brand new one. Check {@link builds/guides/development/custom-builds Custom builds} for details on how to change the default builds to match your preferences.
+If a build does not provide all the necessary features or you want to create a highly optimized build of the editor which will contain only the features that you require, you need to customize the build or create a brand new one. Check {@link builds/guides/development/custom-builds Custom builds} for details on how to change the default builds to match your preferences.
 
 ## Additional information
 
@@ -77,7 +77,7 @@ Each build was designed to satisfy as many use cases as possible. They differ in
 * Provide setups as generic as possible, based on research and community feedback.
 
 <info-box>
-	Features like fonts, colors and alignment will be introduced in the future, when the new types of builds will be introduced with the purpose of satisfying document editing scenarios.
+	Features like fonts, colors and alignment will be introduced in the future, when new types of builds will be introduced with the purpose of satisfying document editing scenarios.
 </info-box>
 
 ### Use cases
@@ -88,15 +88,15 @@ The following are **some** common use cases:
 
 * In content management systems:
 	* Forms for writing articles or website content.
-	* Inline writing in a front-end-like editing page.
-	* In comments.
+	* Inline writing in a frontend-like editing page.
+	* Comments.
 * In marketing and sales automation applications:
-	* Composing e-mail campaigns.
+	* Composing email campaigns.
 	* Creating templates.
 * In forum applications:
-	* Creation of topics and their replies.
+	* Creating topics and their replies.
 * In team collaboration applications:
-	* Creation of shared documents.
+	* Creating shared documents.
 * Other uses:
 	* User profile editing pages.
 	* Book writing applications.
@@ -107,7 +107,7 @@ The following are **some** common use cases:
 
 The {@link framework/index CKEditor 5 Framework} should be used, instead of builds, in the following cases:
 
-* When you want to create your own text editor and have full control over every aspect of it, from UI to features.
+* When you want to create your own text editor and have full control over its every aspect, from UI to features.
 * When the solution proposed by the builds does not fit your specific use case.
 
 In the following cases [CKEditor 4](https://ckeditor.com/ckeditor-4/) should be used instead:

+ 3 - 2
docs/builds/guides/quick-start.md

@@ -7,9 +7,9 @@ category: builds-guides
 order: 30
 ---
 
-Creating an editor using CKEditor 5 build is very simple and in short can be described in two steps:
+Creating an editor using a CKEditor 5 build is very simple and can be described in two steps:
  
-1. Load the desired editor via `<script>` tag.
+1. Load the desired editor via the `<script>` tag.
 2. Call the static `create` method to create the editor.
 
 ## Classic editor
@@ -89,6 +89,7 @@ Call the {@link module:editor-inline/inlineeditor~InlineEditor#create `InlineEdi
 </body>
 </html>
 ```
+
 ## Balloon toolbar editor
 
 In your HTML page add an element that CKEditor should make editable:

+ 6 - 6
docs/builds/guides/whats-new.md

@@ -15,13 +15,13 @@ CKEditor 5 strives to provide a truly seamless, distraction-free editing experie
 
 ### Better images
 
-Inserting images into the content is now very intuitive, with all technical aspects (uploading, resizing) hidden from the user experience. No more complex dialogs.
+Inserting images into the content is now very intuitive, with all technical aspects (uploading, resizing) hidden from the user experience. No more complex dialogs!
 
 [ TODO Animated GIF of pasting ]
 
 [ TODO Animated GIF of DnD ]
 
-The outdated concept of image "alignment" was dropped in favor of {@link features/image#Image-styles image styles}:
+The outdated concept of image alignment was dropped in favor of {@link features/image#Image-styles image styles}:
 
 [ TODO Animated GIF of styles ]
 
@@ -55,13 +55,13 @@ The editor content is now placed inline in the page &mdash; it is now much easie
 
 [ TODO Animated GIF of the editor growing when typing ]
 
-## Less features == better content
+## Fewer features == better content
 
 We focused on creating a tool for writing quality content. At the same time, we simplified the integration of the editor into your system.
 
-We feel that in previous editor versions we had way too many features and configurations. This was confusing developers and at the same time negatively impacting the end-user experience.
+We feel that in previous editor versions we had way too many features and configurations. This was confusing developers and at the same time negatively impacting the end user experience.
 
-In CKEditor 5 misleading formatting tools were removed, dialogs were stripped out or simplified in favor of well designed features that require no configuration.
+In CKEditor 5 misleading formatting tools were removed, dialogs were stripped out or simplified in favor of well-designed features that require no configuration.
 
 {@img assets/img/feature-toolbar.png 610 Simplified toolbar with features designed for writing quality content.}
 
@@ -71,7 +71,7 @@ The editor is much more lightweight and fast. It brings a fantastic user experie
 
 ## Highly customizable
 
-CKEditor 5 Builds are based on the {@link framework/index CKEditor 5 Framework}, which gives powerful customizability and extensibility possibilities.
+CKEditor 5 Builds are based on the {@link framework/index CKEditor 5 Framework}, which gives powerful customizability and extensibility.
 
 ## Custom data model
 

+ 1 - 1
docs/builds/index.md

@@ -17,4 +17,4 @@ CKEditor 5 Builds are the fastest and easiest way to use CKEditor 5 in your appl
 
 ## Contribute
 
-CKEditor is an Open Source project and your contribution is most welcome. Feel free to {@link builds/guides/reporting-issues report bugs} or improve the code on [GitHub](https://github.com/ckeditor/ckeditor5). Since CKEditor is localized, you can also help [translating it](https://www.transifex.com/ckeditor/ckeditor5/). You do not need to be a programmer to contribute to the project!
+CKEditor is an Open Source project and your contribution is most welcome. Feel free to {@link builds/guides/reporting-issues report bugs} or improve the code on [GitHub](https://github.com/ckeditor/ckeditor5). Since CKEditor is localized, you can also help [to translate it](https://www.transifex.com/ckeditor/ckeditor5/). You do not need to be a programmer to contribute to the project!