docs: optimize content

Author: dmihaylo

docs/styles-and-layout/how-to/change-themes-on-the-client.md

@@ -1,16 +1,19 @@
 ---
 title: Change Themes on the Client
-page_title: Change Themes on the Client | Kendo UI Desktop Widgets
-description: "Learn how to change themes on the client when styling the Kendo UI desktop widgets and controls for data visualization."
+page_title: Change Themes on the Client | Kendo UI Styles and Appearance
+description: "Learn how to change themes on the client when styling the Kendo UI widgets."
 slug: howto_changethemes_ontheclient_styleskendoui
-position: 1
 ---
 
 # Change Themes on the Client
 
-The example below demonstrates a possible way to switch Kendo UI themes on the client.
+The following example demonstrates a possible way for you to switch the Kendo UI themes on the client by replacing the CSS stylesheets.
 
-The core functionality of the following demo is replacing CSS stylesheets on the client, which is not something related to Kendo UI and does not require any Kendo UI APIs. From this point of view, the example is provided "as is", and may need customization and tweaking depending on the specific scenario, requirements, browser support, etc.
+Because this approach is not related to the functionalities of the Kendo UI suite, it does not require you to apply Kendo UI API calls. As a result, depending on the requirements of your project, you might have to customize and tweak the code.
+
+> **Important**
+>
+> To achieve a dynamic switching from or to [SASS themes]({% slug sassbasedthemes_kendoui %}), the page has to be fully reloaded (`location.reload()`). The reason for this behavior is that the common resources that are used are different and the browser is not capable of dynamically unloading the resources that are not necessary.
 
 ```html
 
@@ -135,21 +138,15 @@ The core functionality of the following demo is replacing CSS stylesheets on the
 
 ```
 
-> Important
->
-> When switching dynamically from/to [SASS themes]({%slug sassbasedthemes_kendoui%}) the page should be fully reloaded (`location.reload()`).
->
-> This is due to differences with the common resources used and the incapability of browser to dynamically unload the unneeded ones.
-
 ## See Also
 
 Other articles on styling, appearance, and rendering of Kendo UI widgets:
 
 * [Themes and Appearance of the Kendo UI Widgets]({% slug themesandappearnce_kendoui_desktopwidgets %})
 * [Responsive Web Design]({% slug responsivewebdesign_integration_kendoui %})
 * [Web Font Icons]({% slug webfonticons_kendoui_desktopwidgets %})
-* [Sass ThemeBuilder Overview]({% slug sassbasedthemes_kendoui %}#sass-theme-builder)
-* [Less ThemeBuilder Overview]({% slug themesandappearnce_kendoui_desktopwidgets %}#less-theme-builder)
+* [SASS ThemeBuilder Overview]({% slug sassbasedthemes_kendoui %}#sass-theme-builder)
+* [LESS ThemeBuilder Overview]({% slug themesandappearnce_kendoui_desktopwidgets %}#less-theme-builder)
 * [Rendering Modes for Data Visualization]({% slug renderingmodesfor_datavisualization_kendouistyling %})
 * [Troubleshooting]({% slug commonissues_troubleshooting_kendouistyling %})
 * [Themes and Appearance of the Kendo UI Hybrid Widgets](/controls/hybrid/styling)

docs/styles-and-layout/sass-themes.md

@@ -15,17 +15,7 @@ Currently, Kendo UI delivers a single SASS theme. This is the **Default v2** the
 
 ## Overview
 
-Apart from being written in a different language, the SASS-based themes are slightly different from the LESS-based ones. This article outlines those differences and shows how you can use the SASS-based themes.
-
-> **Important**  
->
-> Sass based themes utilize some CSS features that are not supported by Internet Explorer 10 and earlier:
->
-> * flexbox layout (not supported in IE 10 and earlier)
-> * CSS gradients (not supported in IE 9 and earlier)
-> * Web Open Font Format (not supported in IE 8 and earlier)
-> * Border radius (not supported in IE 8 and earlier)
-> * Alpha transparency colors (not supported in IE 8 and earlier)
+Apart from being written in a different language, the SASS-based themes are slightly different from the LESS-based ones. This article outlines those differences and demonstrates how to use the SASS-based themes.
 
 ## Differences
 
@@ -36,6 +26,16 @@ In Kendo UI, the SASS-based themes demonstrate the following differences from th
 - The SASS-based themes are available on NPM. Each theme is stored as an NPM package and can be easily upgraded.
 - Each SASS-based theme is compatible with the [Kendo UI components for Angular 2](http://www.telerik.com/kendo-angular-ui/). This enables you to port parts of your application to Angular 2 while maintaining their styling.
 
+## Browser Limitations
+
+The following CSS features, which are used by the SASS-based themes, provide limited browser support:
+
+* Flexbox layout—Not supported by Internet Explorer 10 and earlier.
+* CSS gradients—Not supported by Internet Explorer 9 and earlier.
+* Web Open Font Format—Not supported by Internet Explorer 8 and earlier.
+* Border radius—Not supported by Internet Explorer 8 and earlier.
+* Alpha transparency colors—Not supported by Internet Explorer 8 and earlier.
+
 ## Getting the Themes
 
 To get the SASS-based Kendo UI themes, you can:
@@ -598,21 +598,21 @@ Outputs a module once, no matter how many times it is included.
 
 To contribute to the development of the Kendo UI Default Theme, refer to the [telerik/kendo-theme-default](https://github.com/telerik/kendo-theme-default) GitHub repository it is stored in.
 
-## Sass Theme Builder
+## SASS Theme Builder
 
 [**Progress Sass Theme Builder**](http://themebuilder.telerik.com/aspnet-mvc) for Kendo UI is an Angular web application that enables you to create new or customize existing themes.
 
-The tool renders the same look and feel as the look and feel of all other components in the suite. It also delivers full control over the skin elements of each component and automatically updates its composite units. After you create the skin and achieve the desired look of the theme, the Sass Theme Builder enables you to download and integrate it in your project.  
+The tool renders the same look and feel as the look and feel of all other components in the suite. It also delivers full control over the skin elements of each component and automatically updates its composite units. After you create the skin and achieve the desired look of the theme, the SASS Theme Builder enables you to download and integrate it in your project.  
 
-**Figure 1: A preview of the Sass Theme Builder**
+**Figure 1: A preview of the SASS Theme Builder**
 
 ![Theme Builder Overview](images/theme-builder-overview.png)
 
 ### Creating New Themes
 
 To create a new theme:
 
-1. On the initial Sass Theme Builder pane, select the **Start Theming** option.
+1. On the initial SASS Theme Builder pane, select the **Start Theming** option.
 1. Choose one of the existing skins to use as a base. The currently available built-in skins are **Default** and **Bootsrap**.
 
     **Figure 2: Selecting a base theme**
@@ -621,7 +621,7 @@ To create a new theme:
 
 ### Customizing Existing Themes
 
-The Sass Theme Builder supports the following options for customization:
+The SASS Theme Builder supports the following options for customization:
 
 * Color pickers which customize the appearance of the components.
 * The **Apply changes instantly** option which enables you to observe the changes on the fly.
@@ -630,7 +630,7 @@ The Sass Theme Builder supports the following options for customization:
 
 #### Functionalities for Customization
 
-To customize an existing theme, use the following Sass Theme Builder functionalities:
+To customize an existing theme, use the following SASS Theme Builder functionalities:
 
 1. **Color Swatches**—Contains predefined color palettes that you can apply to all components in your application.
 1. **Default**—Provides the applicable color customization options.
@@ -645,7 +645,7 @@ To customize an existing theme, use the following Sass Theme Builder functionali
 
 To upload an existing theme you have previously created:
 
-1. On the initial Sass Theme Builder pane, select **Import Theme**.
+1. On the initial SASS Theme Builder pane, select **Import Theme**.
 1. Upload the `variables.scss` file which contains your current modifications of the customized theme. As a result, the selected components and styling elements load.
 1. Start [customizing your theme](#customizing-existing-themes).