Bladeren bron

Merge branch 'master' into t/686

Kamil Piechaczek 8 jaren geleden
bovenliggende
commit
3a7d07e11d

BIN
.github/ckeditor 5 classic screeshot.png


+ 223 - 158
README.md

@@ -1,4 +1,4 @@
-CKEditor 5 – development repository
+CKEditor 5 [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=Check%20out%20CKEditor%205%20on%20GitHub%20&url=https://github.com/ckeditor/ckeditor5)
 ===================================
 
 [![Join the chat at https://gitter.im/ckeditor/ckeditor5](https://badges.gitter.im/ckeditor/ckeditor5.svg)](https://gitter.im/ckeditor/ckeditor5?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -6,31 +6,83 @@ CKEditor 5 – development repository
 [![Dependency Status](https://img.shields.io/david/ckeditor/ckeditor5.svg)](https://david-dm.org/ckeditor/ckeditor5)
 [![devDependency Status](https://img.shields.io/david/dev/ckeditor/ckeditor5.svg)](https://david-dm.org/ckeditor/ckeditor5?type=dev)
 
-## Project Status (November 2017)
+A set of ready to use rich text editors created with a powerful framework. Made with real-time collaborative editing in mind.
 
-1.0.0-alpha.2 was released on November 14, 2017. This is the 13th developer preview of the new CKEditor 5.
+![CKEditor 5 Classic editor build screenshot](https://github.com/ckeditor/ckeditor5/blob/master/.github/ckeditor%205%20classic%20screeshot.png)
 
-Read more about the status of the project in the [CKEditor 5 v1.0.0-alpha.2 release blog post](https://github.com/ckeditor/ckeditor5-design/issues/182).
+## Table of contents
 
-The first alpha versions will be followed by several releases before CKEditor 5 reaches v1.0.0. See the [roadmap to 1.0.0 and beyond](https://github.com/ckeditor/ckeditor5-design/issues/172).
+* [Quick start](#quick-start)
+   * [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)
+   * [Ideas and discussions](#ideas-and-discussions)
+   * [Development](#development)
+   * [Reporting issues and feature requests](#reporting-issues-and-feature-requests)
+* [Releases](#releases)
+* [Packages](#packages)
+   * [Core libraries](#core-libraries)
+   * [Editors](#editors)
+   * [Features](#features)
+   * [Themes](#themes)
+   * [Builds](#builds)
+* [License](#license)
 
-## Demos
+## Quick start
 
-To play with the editors see the [CKEditor 5 Builds](https://ckeditor.com/ckeditor-5-builds/) website.
+### CKEditor 5 Builds
 
-You can also find out more examples (such as [Markdown output](https://docs.ckeditor.com/ckeditor5/latest/features/markdown.html) or [text autoformatting](https://docs.ckeditor.com/ckeditor5/latest/features/autoformat.html)) in the [Features](https://docs.ckeditor.com/ckeditor5/latest/features/index.html) section of the documentation.
+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.
 
-### Follow us!
+The following CKEditor 5 Builds are currently available:
 
-* [Periodic news and updates](https://github.com/ckeditor/ckeditor5-design/labels/announcement) about the project.
-* [Roadmap to 1.0.0 and beyond](https://github.com/ckeditor/ckeditor5-design/issues/172).
+* [Classic editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Classic-editor)
+* [Inline editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Inline-editor)
+* [Balloon editor](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/overview.html#Balloon-editor)
 
-## Documentation
+#### Example
 
-For a high-level overview of the project see:
+Creating an editor using a CKEditor 5 build is very simple and can be described in two steps:
 
-* [CKEditor 5 Builds](https://ckeditor.com/ckeditor-5-builds/) website
-* [CKEditor 5 Framework](https://ckeditor.com/ckeditor-5-framework/) website.
+1. Load the desired editor via the `<script>` tag.
+2. Call the static `create()` method to create the editor.
+
+In your HTML page add an element that CKEditor should replace:
+
+```html
+<textarea name="content" id="editor"></textarea>
+```
+
+Load the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+
+```html
+<script src="https://cdn.ckeditor.com/ckeditor5/<version>/classic/ckeditor.js"></script>
+```
+
+Call the [`ClassicEditor.create()`](https://docs.ckeditor.com/ckeditor5/latest/api/module_editor-classic_classiceditor-ClassicEditor.html#create) method:
+
+```html
+<script>
+    ClassicEditor
+        .create( document.querySelector( '#editor' ) )
+        .catch( error => {
+            console.error( error );
+        } );
+</script>
+```
+
+You’re ready to go!
+
+To find out how to start with other builds please go to the [quick start section of CKEditor 5 documentation](https://docs.ckeditor.com/ckeditor5/latest/builds/guides/quick-start.html).
+
+### 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.
+
+To find out how to start building your own editor from scratch go to [CKEditor 5 Framework overview section of CKEditor 5 documentation](https://docs.ckeditor.com/ckeditor5/latest/framework/guides/overview.html).
+
+## Documentation and FAQ
 
 To find out more see the following [CKEditor 5 documentation](https://docs.ckeditor.com/ckeditor5/latest/index.html) sections:
 
@@ -42,13 +94,14 @@ To find out more see the following [CKEditor 5 documentation](https://docs.ckedi
 
 The documentation is far from being complete and will be constantly evolving (as will the editor) until it is ready for v1.0.0.
 
-## Project Organization
+For FAQ please go to the [CKEditor Ecosystem help center](https://support.ckeditor.com/hc/en-us).
+For a high-level overview of the project see the [CKEditor Ecosystem website](https://ckeditor.com).
 
-### Design and discussions
+## Contributing and project organization
 
-[https://github.com/ckeditor/ckeditor5](https://github.com/ckeditor/ckeditor5) is the CKEditor 5 main development repository. This is the best place for bringing opinions and contributions. Letting the core team know if they are going in the right or wrong direction is great feedback and will be much appreciated!
+### Ideas and discussions
 
-(Note: At the early stage, most of the high-level discussions were lead in [ckeditor5-design](https://github.com/ckeditor/ckeditor5-design/issues) repository.)
+The main development repository of CKEditor 5 is located at [https://github.com/ckeditor/ckeditor5](https://github.com/ckeditor/ckeditor5). This is the best place for bringing opinions and contributions. Letting the core team know if they are going in the right or wrong direction is great feedback and will be much appreciated!
 
 ### Development
 
@@ -62,6 +115,18 @@ Each repository independently handles its issues. However, it's recommended to r
 
 Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/guides/support/getting-support.html) page.
 
+## Releases
+
+The latest five releases:
+
+* [Second alpha release of CKEditor 5 v1.0.0](https://ckeditor.com/blog/Second-alpha-release-of-CKEditor-5-v1.0.0/) (<time datetime="2017-11-14T12:52:18Z"><i>Nov 14, 2017</i></time>)
+* [First alpha release of CKEditor 5 v1.0.0](https://ckeditor.com/blog/First-alpha-release-of-CKEditor-5-v1.0.0/) (<time datetime="2017-10-03T13:09:29Z"><i>Oct 3, 2017</i></time>)
+* [11th developer preview of CKEditor 5](https://ckeditor.com/blog/11th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-09-03T19:35:48Z"><i>Sep 3, 2017</i></time>)
+* [10th developer preview of CKEditor 5 available](https://ckeditor.com/blog/10th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-05-07T21:57:04Z"><i>May 7, 2017</i></time>)
+* [9th developer preview of CKEditor 5 available](https://ckeditor.com/blog/9th-developer-preview-of-CKEditor-5-available/) (<time datetime="2017-04-05T17:58:27Z"><i>Apr 5, 2017</i></time>)
+
+For more CKEditor 5 release blog posts [browse the CKEditor blog](https://ckeditor.com/blog/?category=releases&tags=CKEditor-5).
+
 ## Packages
 
 ### Core libraries
@@ -69,8 +134,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -78,78 +144,84 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-engine"><code>@ckeditor/ckeditor5-engine</code></a>
-		<br>
-		The editing engine.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-engine"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-engine.svg" alt="ckeditor5-engine npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-engine"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-engine/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-engine/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-engine.svg" alt="ckeditor5-engine coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-engine"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-engine.svg" alt="@ckeditor/ckeditor5-engine npm package badge"></a>
+	</td>
+	<td>
+		The editing engine.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-core"><code>@ckeditor/ckeditor5-core</code></a>
-		<br>
-		The core editor architecture.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-core"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-core.svg" alt="ckeditor5-core npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-core"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-core/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-core/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-core.svg" alt="ckeditor5-core coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-core"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-core.svg" alt="@ckeditor/ckeditor5-core npm package badge"></a>
+	</td>
+	<td>
+		The core editor architecture.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-ui"><code>@ckeditor/ckeditor5-ui</code></a>
-		<br>
-		The editor UI library.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-ui"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-ui.svg" alt="ckeditor5-ui npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-ui"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-ui/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-ui/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-ui.svg" alt="ckeditor5-ui coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-ui"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-ui.svg" alt="@ckeditor/ckeditor5-ui npm package badge"></a>
+	</td>
+	<td>
+		The editor UI library.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-utils"><code>@ckeditor/ckeditor5-utils</code></a>
-		<br>
-		The editor utilities library.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-utils"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-utils.svg" alt="ckeditor5-utils npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-utils"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-utils/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-utils/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-utils.svg" alt="ckeditor5-utils coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-utils"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-utils.svg" alt="@ckeditor/ckeditor5-utils npm package badge"></a>
+	</td>
+	<td>
+		The editor utilities library.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-upload"><code>@ckeditor/ckeditor5-upload</code></a>
-		<br>
-		Introduces the file upload utilities.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-upload"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-upload.svg" alt="ckeditor5-upload npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-upload"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-upload/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-upload/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-upload.svg" alt="ckeditor5-upload coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-upload"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-upload.svg" alt="@ckeditor/ckeditor5-upload npm package badge"></a>
+	</td>
+	<td>
+		Introduces the file upload utilities.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-widget"><code>@ckeditor/ckeditor5-widget</code></a>
-		<br>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-widget"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-widget.svg" alt="@ckeditor/ckeditor5-widget npm package badge"></a>
+	</td>
+	<td>
 		Introduces the widget API.
 	</td>
+</tr>
+
+<tr>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-widget"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-widget.svg" alt="ckeditor5-widget npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-widget"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-widget/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-widget/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-widget.svg" alt="ckeditor5-widget coverage badge"></a>
+		<a href="https://github.com/ckeditor/ckeditor5-cloudservices"><code>@ckeditor/ckeditor5-cloudservices</code></a>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-cloudservices"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-cloudservices.svg" alt="@ckeditor/ckeditor5-cloudservices npm package badge"></a>
+	</td>
+	<td>
+		CKEditor 5's Cloud Services integration layer.
 	</td>
 </tr>
 
@@ -161,8 +233,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -170,39 +243,36 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-classic"><code>@ckeditor/ckeditor5-editor-classic</code></a>
-		<br>
-		The classic editor implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-classic.svg" alt="ckeditor5-editor-classic npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-classic/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-classic/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-classic.svg" alt="ckeditor5-editor-classic coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-classic.svg" alt="@ckeditor/ckeditor5-editor-classic npm package badge"></a>
+	</td>
+	<td>
+		The classic editor implementation.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-inline"><code>@ckeditor/ckeditor5-editor-inline</code></a>
-		<br>
-		The inline editor implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-inline.svg" alt="ckeditor5-editor-inline npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-inline/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-inline/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-inline.svg" alt="ckeditor5-editor-inline coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-inline.svg" alt="@ckeditor/ckeditor5-editor-inline npm package badge"></a>
+	</td>
+	<td>
+		The inline editor implementation.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-editor-balloon"><code>@ckeditor/ckeditor5-editor-balloon</code></a>
-		<br>
-		The balloon editor (Medium-like) implementation.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-balloon.svg" alt="ckeditor5-editor-balloon npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-editor-balloon/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-editor-balloon/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-editor-balloon.svg" alt="ckeditor5-editor-balloon coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-editor-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-editor-balloon.svg" alt="@ckeditor/ckeditor5-editor-balloon npm package badge"></a>
+	</td>
+	<td>
+		The balloon editor (Medium-like) implementation.
 	</td>
 </tr>
 
@@ -214,8 +284,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -223,195 +294,180 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-adapter-ckfinder"><code>@ckeditor/ckeditor5-adapter-ckfinder</code></a>
-		<br>
-		Introduces the <a href="https://ckeditor.com/ckeditor-4/ckfinder/">CKFinder</a> adapter for features which require upload capabilities.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-adapter-ckfinder.svg" alt="ckeditor5-adapter-ckfinder npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-adapter-ckfinder/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-adapter-ckfinder/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-adapter-ckfinder.svg" alt="ckeditor5-adapter-ckfinder coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-adapter-ckfinder"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-adapter-ckfinder.svg" alt="@ckeditor/ckeditor5-adapter-ckfinder npm package badge"></a>
+	</td>
+	<td>
+		Introduces the <a href="https://ckeditor.com/ckeditor-4/ckfinder/">CKFinder</a> adapter for features which require upload capabilities.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-autoformat"><code>@ckeditor/ckeditor5-autoformat</code></a>
-		<br>
-		Introduces the autoformatting feature. Replaces predefined characters with a corresponding format (e.g. <code>**foo**</code> becomes bolded <code>&lt;strong&gt;foo&lt;/strong&gt;</code>).
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-autoformat.svg" alt="ckeditor5-autoformat npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-autoformat/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-autoformat/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-autoformat.svg" alt="ckeditor5-autoformat coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-autoformat"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-autoformat.svg" alt="@ckeditor/ckeditor5-autoformat npm package badge"></a>
+	</td>
+	<td>
+		Introduces the autoformatting feature. Replaces predefined characters with a corresponding format (e.g. <code>**foo**</code> becomes bolded <code>&lt;strong&gt;foo&lt;/strong&gt;</code>).
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-basic-styles"><code>@ckeditor/ckeditor5-basic-styles</code></a>
-		<br>
-		Introduces the bold, italic, underline and code features.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-basic-styles.svg" alt="ckeditor5-basic-styles npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-basic-styles/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-basic-styles/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-basic-styles.svg" alt="ckeditor5-basic-styles coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-basic-styles"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-basic-styles.svg" alt="@ckeditor/ckeditor5-basic-styles npm package badge"></a>
+	</td>
+	<td>
+		Introduces the bold, italic, underline and code features.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-block-quote"><code>@ckeditor/ckeditor5-block-quote</code></a>
-		<br>
-		Introduces the block quote feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-block-quote.svg" alt="ckeditor5-block-quote npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-block-quote/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-block-quote/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-block-quote.svg" alt="ckeditor5-block-quote coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-block-quote"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-block-quote.svg" alt="@ckeditor/ckeditor5-block-quote npm package badge"></a>
+	</td>
+	<td>
+		Introduces the block quote feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-clipboard"><code>@ckeditor/ckeditor5-clipboard</code></a>
-		<br>
-		Introduces the clipboard integration.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-clipboard.svg" alt="ckeditor5-clipboard npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-clipboard/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-clipboard/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-clipboard.svg" alt="ckeditor5-clipboard coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-clipboard"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-clipboard.svg" alt="@ckeditor/ckeditor5-clipboard npm package badge"></a>
+	</td>
+	<td>
+		Introduces the clipboard integration.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-enter"><code>@ckeditor/ckeditor5-enter</code></a>
-		<br>
-		Introduces the Enter key feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-enter"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-enter.svg" alt="ckeditor5-enter npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-enter"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-enter/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-enter/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-enter.svg" alt="ckeditor5-enter coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-enter"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-enter.svg" alt="@ckeditor/ckeditor5-enter npm package badge"></a>
+	</td>
+	<td>
+		Introduces the Enter key feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-easy-image"><code>@ckeditor/ckeditor5-easy-image</code></a>
-		<br>
-		Introduces Easy Image with Cloud Services feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-easy-image.svg" alt="ckeditor5-easy-image npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-easy-image/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-easy-image/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-easy-image.svg" alt="ckeditor5-easy-image coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-easy-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-easy-image.svg" alt="@ckeditor/ckeditor5-easy-image npm package badge"></a>
+	</td>
+	<td>
+		Introduces Easy Image with Cloud Services feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-heading"><code>@ckeditor/ckeditor5-heading</code></a>
-		<br>
-		Introduces the heading feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-heading"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-heading.svg" alt="ckeditor5-heading npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-heading"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-heading/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-heading/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-heading.svg" alt="ckeditor5-heading coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-heading"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-heading.svg" alt="@ckeditor/ckeditor5-heading npm package badge"></a>
+	</td>
+	<td>
+		Introduces the heading feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-image"><code>@ckeditor/ckeditor5-image</code></a>
-		<br>
-		Introduces the image feature. Supports image styles and captioning.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-image.svg" alt="ckeditor5-image npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-image"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-image/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-image/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-image.svg" alt="ckeditor5-image coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-image"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-image.svg" alt="@ckeditor/ckeditor5-image npm package badge"></a>
+	</td>
+	<td>
+		Introduces the image feature. Supports image styles and captioning.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-link"><code>@ckeditor/ckeditor5-link</code></a>
-		<br>
-		Introduces the link feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-link"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-link.svg" alt="ckeditor5-link npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-link"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-link/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-link/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-link.svg" alt="ckeditor5-link coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-link"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-link.svg" alt="@ckeditor/ckeditor5-link npm package badge"></a>
+	</td>
+	<td>
+		Introduces the link feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-list"><code>@ckeditor/ckeditor5-list</code></a>
-		<br>
-		Introduces numbered and bulleted lists feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-list"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-list.svg" alt="ckeditor5-list npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-list"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-list/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-list/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-list.svg" alt="ckeditor5-list coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-list"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-list.svg" alt="@ckeditor/ckeditor5-list npm package badge"></a>
+	</td>
+	<td>
+		Introduces numbered and bulleted lists feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-markdown-gfm"><code>@ckeditor/ckeditor5-markdown-gfm</code></a>
-		<br>
-		Introduces GitHub-flavored Markdown data processor.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-markdown-gfm.svg" alt="ckeditor5-markdown-gfm npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-markdown-gfm/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-markdown-gfm/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-markdown-gfm.svg" alt="ckeditor5-markdown-gfm coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-markdown-gfm"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-markdown-gfm.svg" alt="@ckeditor/ckeditor5-markdown-gfm npm package badge"></a>
+	</td>
+	<td>
+		Introduces GitHub-flavored Markdown data processor.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-paragraph"><code>@ckeditor/ckeditor5-paragraph</code></a>
-		<br>
-		Introduces the paragraph feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-paragraph.svg" alt="ckeditor5-paragraph npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-paragraph/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-paragraph/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-paragraph.svg" alt="ckeditor5-paragraph coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-paragraph"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-paragraph.svg" alt="@ckeditor/ckeditor5-paragraph npm package badge"></a>
+	</td>
+	<td>
+		Introduces the paragraph feature.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-typing"><code>@ckeditor/ckeditor5-typing</code></a>
-		<br>
-		Introduces typing and deleting features.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-typing"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-typing.svg" alt="ckeditor5-typing npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-typing"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-typing/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-typing/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-typing.svg" alt="ckeditor5-typing coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-typing"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-typing.svg" alt="@ckeditor/ckeditor5-typing npm package badge"></a>
+	</td>
+	<td>
+		Introduces typing and deleting features.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-undo"><code>@ckeditor/ckeditor5-undo</code></a>
-		<br>
-		Introduces the undo feature.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-undo"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-undo.svg" alt="ckeditor5-undo npm package badge"></a>
-		<a href="https://travis-ci.org/ckeditor/ckeditor5-undo"><img src="https://img.shields.io/travis/ckeditor/ckeditor5-undo/master.svg" alt="build status badge"></a>
-		<a href="https://codeclimate.com/github/ckeditor/ckeditor5-undo/coverage"><img src="https://img.shields.io/codeclimate/coverage/github/ckeditor/ckeditor5-undo.svg" alt="ckeditor5-undo coverage badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-undo"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-undo.svg" alt="@ckeditor/ckeditor5-undo npm package badge"></a>
+	</td>
+	<td>
+		Introduces the undo feature.
 	</td>
 </tr>
 
@@ -423,8 +479,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -432,7 +489,11 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-theme-lark"><code>@ckeditor/ckeditor5-theme-lark</code></a>
-		<br>
+	</td>
+	<td>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-theme-lark"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-theme-lark.svg" alt="@ckeditor/ckeditor5-theme-lark npm package badge"></a>
+	</td>
+	<td>
 		The Lark theme.
 	</td>
 	<td>
@@ -449,8 +510,9 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <table>
 <thead>
 	<tr>
-		<th>Package</th>
-		<th>Status</th>
+		<th width="30%">Name</th>
+		<th width="15%">Version</th>
+		<th width="55%">Description</th>
 	</tr>
 </thead>
 <tbody>
@@ -458,33 +520,36 @@ Read more in the [Support](https://docs.ckeditor.com/ckeditor5/latest/framework/
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-classic"><code>@ckeditor/ckeditor5-build-classic</code></a>
-		<br>
-		The classic editor build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-classic.svg" alt="ckeditor5-build-classic npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-classic"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-classic.svg" alt="@ckeditor/ckeditor5-build-classic npm package badge"></a>
+	</td>
+	<td>
+		The classic editor build.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-inline"><code>@ckeditor/ckeditor5-build-inline</code></a>
-		<br>
-		The inline editor build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-inline.svg" alt="ckeditor5-build-inline npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-inline"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-inline.svg" alt="@ckeditor/ckeditor5-build-inline npm package badge"></a>
+	</td>
+	<td>
+		The inline editor build.
 	</td>
 </tr>
 
 <tr>
 	<td>
 		<a href="https://github.com/ckeditor/ckeditor5-build-balloon"><code>@ckeditor/ckeditor5-build-balloon</code></a>
-		<br>
-		The balloon editor (Medium-like) build.
 	</td>
 	<td>
-		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-balloon.svg" alt="ckeditor5-build-balloon npm package badge"></a>
+		<a href="https://www.npmjs.com/package/@ckeditor/ckeditor5-build-balloon"><img src="https://img.shields.io/npm/v/@ckeditor/ckeditor5-build-balloon.svg" alt="@ckeditor/ckeditor5-build-balloon npm package badge"></a>
+	</td>
+	<td>
+		The balloon editor (Medium-like) build.
 	</td>
 </tr>
 

+ 10 - 6
docs/builds/guides/development/custom-builds.md

@@ -26,7 +26,7 @@ Some of the reasons for creating custom builds are:
 Start with [forking](https://help.github.com/articles/fork-a-repo/) one of the official builds (it will serve as the starting point for your custom one) and then clone your fork:
 
 ```bash
-git clone https://github.com/<your-username>/ckeditor5-build-classic.git
+git clone -b stable https://github.com/<your-username>/ckeditor5-build-classic.git
 ```
 
 To make updating easier you may optionally add the original build repository to your Git remotes:
@@ -41,6 +41,10 @@ git remote add upstream https://github.com/ckeditor/ckeditor5-build-classic.git
 	Alternatively, instead of creating a custom build you can {@link builds/guides/integration/advanced-setup#Scenario-2-Building-from-source integrate CKEditor 5 directly from source}. This option allows even greater flexibility and requires less overhead (you will not need to fork the official build).
 </info-box>
 
+<info-box warning>
+	It is important that you use the `stable` branch of a build, not the `master` branch. The `master` branch might contain changes which are not yet compatible with the versions of CKEditor 5 source packages which were published on npm.
+</info-box>
+
 ## Build anatomy
 
 Every build contains the following files:
@@ -106,12 +110,12 @@ module.exports = {
 		'../relative/path/to/some/othercustomplugin'
 	],
 
-	// UI language. Language codes follow the https://en.wikipedia.org/wiki/ISO_639-1 format.
-	language: 'en',
-
 	// Editor configuration.
 	config: {
-		toolbar: [ 'headings', 'bold', 'italic', 'custombutton' ]
+		toolbar: [ 'headings', 'bold', 'italic', 'custombutton' ],
+
+		// UI language. Language codes follow the https://en.wikipedia.org/wiki/ISO_639-1 format.
+		language: 'en'
 	}
 };
 ```
@@ -142,7 +146,7 @@ You may decide to update your build at any time. Since it is a fork of the offic
 
 ```bash
 git fetch upstream
-git merge upstream/master
+git merge upstream/stable
 ```
 
 You should handle eventual conflicts and verify the merged changes. After that, just follow the previous instructions for creating your build and test it.

File diff suppressed because it is too large
+ 2 - 6
docs/builds/guides/integration/advanced-setup.md


File diff suppressed because it is too large
+ 130 - 1
docs/builds/guides/migrate.md


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

@@ -25,7 +25,7 @@ In your HTML page add an element that CKEditor should replace:
 <textarea name="content" id="editor"></textarea>
 ```
 
-Load CKEditor 5, the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the classic editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/classic/ckeditor.js"></script>
@@ -77,7 +77,7 @@ In your HTML page add an element that CKEditor should make editable:
 <div id="editor"></div>
 ```
 
-Load CKEditor 5, the inline editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the inline editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/inline/ckeditor.js"></script>
@@ -129,7 +129,7 @@ In your HTML page add an element that CKEditor should make editable:
 <div id="editor"></div>
 ```
 
-Load CKEditor 5, the balloon editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
+Load the balloon editor build (here [CDN](https://cdn.ckeditor.com/) location is used):
 
 ```html
 <script src="https://cdn.ckeditor.com/ckeditor5/{@var ckeditor5-version}/balloon/ckeditor.js"></script>

+ 6 - 0
docs/builds/guides/support/getting-support.md

@@ -41,3 +41,9 @@ DON'Ts:
 * The editor crashes if I press Enter. Please help.
 
 And most importantly, be kind to everyone.
+
+## Commercial support
+
+CKEditor 5 also comes with commercial licensing benefits, such as direct support from the core CKEditor development team. Commercial licenses are designed with professionals and enterprises in mind.
+
+For more information, check the [CKEditor 5 Pricing page](https://ckeditor.com/ckeditor-5-builds/pricing/).

File diff suppressed because it is too large
+ 87 - 6
docs/features/ui-language.md


+ 6 - 0
docs/framework/guides/support/getting-support.md

@@ -41,3 +41,9 @@ DON'Ts:
 * The editor crashes if I press Enter. Please help.
 
 And most importantly, be kind to everyone.
+
+## Commercial support
+
+CKEditor 5 also comes with commercial licensing benefits, such as direct support from the core CKEditor development team. Commercial licenses are designed with professionals and enterprises in mind.
+
+For more information, check the [CKEditor 5 Pricing page](https://ckeditor.com/ckeditor-5-builds/pricing/).

+ 2 - 2
package.json

@@ -46,9 +46,9 @@
   },
   "devDependencies": {
     "@ckeditor/ckeditor5-dev-docs": "^8.0.0",
-    "@ckeditor/ckeditor5-dev-tests": "^9.0.0",
+    "@ckeditor/ckeditor5-dev-tests": "^10.0.0",
     "eslint": "^4.8.0",
-    "eslint-config-ckeditor5": "^1.0.6",
+    "eslint-config-ckeditor5": "^1.0.7",
     "husky": "^0.14.3",
     "lint-staged": "^4.2.3",
     "lerna": "^2.2.0",

+ 6 - 0
scripts/README.md

@@ -0,0 +1,6 @@
+Looking for CKEditor 5's source?
+================================
+
+This repository (https://github.com/ckeditor/ckeditor5) is the CKEditor 5's development environment. It centralizes various tools such as test runners, documentation and changelog generators, release scripts, etc.
+
+The source code of the editor is split into multiple repositories, one for each of CKEditor 5 packages. Every package is developed at its own pace and in its own context. Check out the list of [CKEditor 5 packages and repositories](https://github.com/ckeditor/ckeditor5#packages).

+ 2 - 4
scripts/docs/snippet-adapter/package.json

@@ -2,13 +2,11 @@
   "name": "ckeditor5-snippet-adapter",
   "private": true,
   "dependencies": {
-    "@ckeditor/ckeditor5-dev-webpack-plugin": "^2.0.18",
+    "@ckeditor/ckeditor5-dev-webpack-plugin": "^3.0.0",
     "babel-minify-webpack-plugin": "^0.2.0",
-    "css-loader": "^0.28.7",
     "extract-text-webpack-plugin": "^3.0.0",
-    "node-sass": "^4.5.3",
     "raw-loader": "^0.5.1",
-    "sass-loader": "^6.0.6",
+    "postcss-loader": "^2.0.8",
     "style-loader": "^0.18.2",
     "webpack": "^3.6.0",
     "webpack-sources": "1.0.1"

+ 11 - 20
scripts/docs/snippet-adapter/snippetadapter.js

@@ -8,7 +8,7 @@
 const path = require( 'path' );
 const fs = require( 'fs' );
 const webpack = require( 'webpack' );
-const { bundler } = require( '@ckeditor/ckeditor5-dev-utils' );
+const { bundler, styles: { getPostCssConfig } } = require( '@ckeditor/ckeditor5-dev-utils' );
 const CKEditorWebpackPlugin = require( '@ckeditor/ckeditor5-dev-webpack-plugin' );
 const ExtractTextPlugin = require( 'extract-text-webpack-plugin' );
 const BabelMinifyPlugin = require( 'babel-minify-webpack-plugin' );
@@ -22,18 +22,12 @@ module.exports = function snippetAdapter( data ) {
 
 	const snippetConfig = readSnippetConfig( data.snippetSource.js );
 	const outputPath = path.join( data.outputPath, data.snippetPath );
-	let sassImportPath;
-
-	if ( snippetConfig.sassImportPath ) {
-		sassImportPath = path.join( path.dirname( data.snippetSource.js ), snippetConfig.sassImportPath );
-	}
 
 	const webpackConfig = getWebpackConfig( {
 		entry: data.snippetSource.js,
 		outputPath,
 		language: snippetConfig.language,
-		minify: data.options.production,
-		sassImportPath
+		minify: data.options.production
 	} );
 
 	let promise;
@@ -88,7 +82,7 @@ function getWebpackConfig( config ) {
 	const plugins = [
 		new ExtractTextPlugin( 'snippet.css' ),
 		new CKEditorWebpackPlugin( {
-			languages: [ config.language || 'en' ]
+			language: config.language || 'en'
 		} ),
 		new webpack.BannerPlugin( {
 			banner: bundler.getLicenseBanner(),
@@ -133,21 +127,18 @@ function getWebpackConfig( config ) {
 					use: [ 'raw-loader' ]
 				},
 				{
-					test: /\.scss$/,
+					test: /\.css$/,
 					use: ExtractTextPlugin.extract( {
 						fallback: 'style-loader',
 						use: [
 							{
-								loader: 'css-loader',
-								options: {
-									minimize: config.minify
-								}
-							},
-							{
-								loader: 'sass-loader',
-								options: {
-									data: config.sassImportPath ? `@import '${ config.sassImportPath }';` : ''
-								}
+								loader: 'postcss-loader',
+								options: getPostCssConfig( {
+									themeImporter: {
+										themePath: require.resolve( '@ckeditor/ckeditor5-theme-lark' )
+									},
+									minify: config.minify
+								} )
 							}
 						]
 					} )