From e0850f1e187e90950f6a595268fb2ff0360c39a1 Mon Sep 17 00:00:00 2001
From: Sergiy Zhovnir <s.zhovnir@atwix.com>
Date: Wed, 11 Sep 2019 09:42:35 +0300
Subject: [PATCH] Adjusted the widget documentations

---
 .../javascript-dev-guide/widgets/widget-multiselect.md    | 2 +-
 .../javascript-dev-guide/widgets/widget-popup-window.md   | 4 +---
 .../javascript-dev-guide/widgets/widget-trim-input.md     | 4 +---
 .../v2.2/javascript-dev-guide/widgets/widget_accordion.md | 2 --
 guides/v2.2/javascript-dev-guide/widgets/widget_alert.md  | 1 -
 .../v2.2/javascript-dev-guide/widgets/widget_calendar.md  | 2 --
 .../javascript-dev-guide/widgets/widget_collapsible.md    | 2 --
 .../v2.2/javascript-dev-guide/widgets/widget_confirm.md   | 2 --
 guides/v2.2/javascript-dev-guide/widgets/widget_dialog.md | 1 -
 .../v2.2/javascript-dev-guide/widgets/widget_dropdown.md  | 2 --
 .../v2.2/javascript-dev-guide/widgets/widget_gallery.md   | 2 --
 .../javascript-dev-guide/widgets/widget_gallery_mg.md     | 2 --
 guides/v2.2/javascript-dev-guide/widgets/widget_list.md   | 1 -
 guides/v2.2/javascript-dev-guide/widgets/widget_loader.md | 2 --
 guides/v2.2/javascript-dev-guide/widgets/widget_menu.md   | 1 -
 guides/v2.2/javascript-dev-guide/widgets/widget_modal.md  | 2 --
 .../javascript-dev-guide/widgets/widget_navigation.md     | 2 --
 .../widgets/widget_password_strength_indicator.md         | 4 +---
 guides/v2.2/javascript-dev-guide/widgets/widget_prompt.md | 2 --
 .../javascript-dev-guide/widgets/widget_quickSearch.md    | 2 --
 .../javascript-dev-guide/widgets/widget_redirectUrl.md    | 8 +++-----
 guides/v2.2/javascript-dev-guide/widgets/widget_tabs.md   | 4 +---
 guides/v2.2/javascript-dev-guide/widgets/widget_toggle.md | 4 +---
 .../v2.3/javascript-dev-guide/widgets/widget_calendar.md  | 4 +---
 24 files changed, 10 insertions(+), 52 deletions(-)

diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget-multiselect.md b/guides/v2.2/javascript-dev-guide/widgets/widget-multiselect.md
index cf4ac6b1c2a..b4019461880 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget-multiselect.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget-multiselect.md
@@ -23,7 +23,7 @@ Where:
 
 - `#multiselect` is the selector of the select element for which Multiselect is initialized.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget-popup-window.md b/guides/v2.2/javascript-dev-guide/widgets/widget-popup-window.md
index 254f0fd5c35..822cda160b4 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget-popup-window.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget-popup-window.md
@@ -6,8 +6,6 @@ contributor_name: Atwix
 contributor_link: https://www.atwix.com/
 ---
 
-## Overview
-
 The PopupWindow [widget](https://glossary.magento.com/widget/) allows you to open a popup window with content from any URL.
 
 The PopupWindow widget source is [lib/web/mage/popup-window.js][].
@@ -35,7 +33,7 @@ Where:
 
 - `#element` is the selector of the element which will be the PopupWindow.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget-trim-input.md b/guides/v2.2/javascript-dev-guide/widgets/widget-trim-input.md
index 85c9f56edd9..4b33f836b23 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget-trim-input.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget-trim-input.md
@@ -6,8 +6,6 @@ contributor_name: Atwix
 contributor_link: https://www.atwix.com/
 ---
 
-## Overview
-
 The TrimInput [widget](https://glossary.magento.com/widget) trims  whitespace in an input field.
 
 The TrimInput widget source is [lib/web/mage/trim-input.js][].
@@ -26,7 +24,7 @@ Where:
 
 - `#element` is the selector of the input element to be trimmed.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_accordion.md b/guides/v2.2/javascript-dev-guide/widgets/widget_accordion.md
index 3eedf7f58c1..f75c43c3281 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_accordion.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_accordion.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Accordion widget
 ---
 
-## Overview
-
 Magento accordion widget is an [extension](https://glossary.magento.com/extension) of the [Magento Tabs widget].
 
 Accordions are generally used to break content into multiple sections that can be swapped to save space.
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_alert.md b/guides/v2.2/javascript-dev-guide/widgets/widget_alert.md
index 7a15918ded2..6a7d81f94ad 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_alert.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_alert.md
@@ -3,7 +3,6 @@ group: javascript-developer-guide
 subgroup: 3_Widgets
 title: Alert widget
 ---
-## Overview {#alert_overview}
 
 The Magento alert widget implements a modal pop-up window with a confirmation button. It extends the [Magento modal widget].
 
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_calendar.md b/guides/v2.2/javascript-dev-guide/widgets/widget_calendar.md
index 55aa0d79c10..086de3fd5a8 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_calendar.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_calendar.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Calendar widget
 ---
 
-## Overview {#fedg_jquery-widget_calendar-overview}
-
 The Calendar widget is a customized jQuery [Datepicker Widget] that enables selecting a data using a pop-up or an in-line calendar. Calendar is also responsible for:
 
 *	Merging the [global configuration] with the options that are passed from PHP when Calendar is initialized.
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_collapsible.md b/guides/v2.2/javascript-dev-guide/widgets/widget_collapsible.md
index 02a1adcae3f..09cdcbdac12 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_collapsible.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_collapsible.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Collapsible widget
 ---
 
-## Overview
-
 The Magento collapsible widget converts a header/content pair into an accordion, where the content is collapsed or expanded on the header click.
 
 Unlike the accordion widget is that collapsible is initialized for one title/content pair, while accordion can be initialized for a set of title/contents pairs.
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_confirm.md b/guides/v2.2/javascript-dev-guide/widgets/widget_confirm.md
index 4054332b5fb..26492cbd0f5 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_confirm.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_confirm.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Confirmation widget
 ---
 
-## Overview
-
 The Magento confirmation widget implements a modal pop-up window with the cancel and confirmation button.It is an [extension](https://glossary.magento.com/extension) of the [Magento modal widget].
 
 The confirmation [widget](https://glossary.magento.com/widget) source is [`<Magento_Ui_module_dir>/view/base/web/js/modal/confirm.js`].
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_dialog.md b/guides/v2.2/javascript-dev-guide/widgets/widget_dialog.md
index dcd24d232c5..f3d54fc50b8 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_dialog.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_dialog.md
@@ -4,7 +4,6 @@ subgroup: 3_Widgets
 title: DropdownDialog widget
 ---
 
-## Overview
 Magento dropdownDialog [widget](https://glossary.magento.com/widget) is a customization of the standard [jQuery UI Dialog](http://api.jqueryui.com/dialog/){:target="_blank"}. As extra functionality it implements the following:
 
 -   triggering [event](https://glossary.magento.com/event) for opening
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_dropdown.md b/guides/v2.2/javascript-dev-guide/widgets/widget_dropdown.md
index 8d04cd5e76e..0ec6d61019d 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_dropdown.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_dropdown.md
@@ -7,8 +7,6 @@ functional_areas:
  - Theme
 ---
 
-## Overview
-
 Use the dropdown widget to display custom content on the storefront.
 
 Widget source file is [lib/web/mage/dropdowns.js].
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_gallery.md b/guides/v2.2/javascript-dev-guide/widgets/widget_gallery.md
index fdf462d74de..9c745663a53 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_gallery.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_gallery.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Gallery widget
 ---
 
-## Overview
-
 The gallery jQuery widget implements a content area with images organized into preview and thumbnails blocks.
 
 The following picture is an illustration of image displaying on the product page using the gallery widget:
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_gallery_mg.md b/guides/v2.2/javascript-dev-guide/widgets/widget_gallery_mg.md
index d1f40d68787..3262a30d11d 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_gallery_mg.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_gallery_mg.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Magnifier widget
 ---
 
-## Overview
-
 Magnifier is a [widget](https://glossary.magento.com/widget) that allows displaying images in 100% scaled size in separate dedicated layer.
 In Magento it is used by the [gallery]({{ page.baseurl }}/javascript-dev-guide/widgets/widget_gallery.html) widget for zooming the product images on product pages.
 
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_list.md b/guides/v2.2/javascript-dev-guide/widgets/widget_list.md
index ac70815f3c0..38be58c511d 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_list.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_list.md
@@ -3,7 +3,6 @@ group: javascript-developer-guide
 subgroup: 3_Widgets
 title: List widget
 ---
-## Overview
 
 {%
 include note.html
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_loader.md b/guides/v2.2/javascript-dev-guide/widgets/widget_loader.md
index 765caca08d4..f39a406dfac 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_loader.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_loader.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Loader widget
 ---
 
-## Overview
-
 The Loader [widget](https://glossary.magento.com/widget) blocks page content (all content or a part of it). Its intended use is blocking content when an Ajax request is being sent, but it can be initialized for non-Ajax tasks as well.
 
 The Loader widget source is [lib/web/mage/loader.js].
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_menu.md b/guides/v2.2/javascript-dev-guide/widgets/widget_menu.md
index 55035466bb5..fe4d78816b7 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_menu.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_menu.md
@@ -3,7 +3,6 @@ group: javascript-developer-guide
 subgroup: 3_Widgets
 title: Menu widget
 ---
-## Overview
 
 The Magento menu widget is a customized [jQuery UI Menu widget](http://api.jqueryui.com/menu/){:target="_blank"}. Magento menu extends the default functionality with the following:
 
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_modal.md b/guides/v2.2/javascript-dev-guide/widgets/widget_modal.md
index 5113e91b9cd..126d2639557 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_modal.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_modal.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Modal widget
 ---
 
-## Overview {#modal_overview}
-
 The Magento modal widget implements a secondary window that opens on top of the main window. It contains the overlay and modal content. The modal widget configuration enables the following:
 
 -   Configuring as popup or slide
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_navigation.md b/guides/v2.2/javascript-dev-guide/widgets/widget_navigation.md
index bb91cdd3675..b849ad75ec6 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_navigation.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_navigation.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Navigation widget
 ---
 
-## Overview
-
 Magento navigation widget is a customized [jQuery UI Menu widget]. Magento navigation extends the default functionality with the following:
 -   Expanding all layers of the menu tree past the second layer.
 -   Limiting the maximum number of list items contained within the main
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_password_strength_indicator.md b/guides/v2.2/javascript-dev-guide/widgets/widget_password_strength_indicator.md
index 44b9ce2fee5..ed081892a5c 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_password_strength_indicator.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_password_strength_indicator.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: PasswordStrengthIndicator widget
 ---
 
-## Overview {#password_strength_indicator_overview}
-
 The Magento password strength indicator [widget](https://glossary.magento.com/widget) provides immediate feedback on the validity and strength of a password while it is being typed.
 If the password is not strong enough, Magento prompts the user to choose a new password.
 
@@ -35,7 +33,7 @@ Where:
 
 - `#password-input` is the selector of the element for which PasswordStrengthIndicator is initialized.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_prompt.md b/guides/v2.2/javascript-dev-guide/widgets/widget_prompt.md
index c99500cfbb6..6fa294f0b48 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_prompt.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_prompt.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Prompt widget
 ---
 
-## Overview
-
 The Magento prompt [widget](https://glossary.magento.com/widget) implements a modal pop-up window with an input field, and a cancel and a confirmation button.
 
 It extends the [Magento modal widget].
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_quickSearch.md b/guides/v2.2/javascript-dev-guide/widgets/widget_quickSearch.md
index 96ace01efc9..18d79434293 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_quickSearch.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_quickSearch.md
@@ -6,8 +6,6 @@ functional_areas:
   - Search
 ---
 
-## Overview
-
 The quickSearch [widget](https://glossary.magento.com/widget) is an autocomplete widget that populates a list of suggested search terms for a given field.
 
 The suggest widget source is [`<Magento_Search_module_dir>/view/frontend/web/js/form-mini.js`].
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_redirectUrl.md b/guides/v2.2/javascript-dev-guide/widgets/widget_redirectUrl.md
index ded51389679..5131ad15322 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_redirectUrl.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_redirectUrl.md
@@ -6,8 +6,6 @@ contributor_name: Atwix
 contributor_link: https://www.atwix.com/
 ---
 
-## Overview
-
 The RedirectUrl [widget](https://glossary.magento.com/widget) allows redirecting to an URL when an event triggers.
 
 The RedirectUrl widget source is [lib/web/mage/redirect-url.js][].
@@ -26,7 +24,7 @@ Where:
 
 - `#element` is the selector of the element for which RedirectUrl is initialized.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
@@ -45,8 +43,8 @@ Phtml template file examples using script:
 
 The RedirectUrl widget has the following options:
 
-- [event]
-- [url]
+- [event](#event)
+- [url](#url)
 
 ### `event`
 
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_tabs.md b/guides/v2.2/javascript-dev-guide/widgets/widget_tabs.md
index 756294af2a6..7ee593436ca 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_tabs.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_tabs.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Tabs widget
 ---
 
-## Overview {#fedg_tabs-widget_overview}
-
 The Magento tabs widget implements single content area with multiple panels, each associated with a header in a list. It uses the [Magento collapsible widget].
 
 The tabs [widget](https://glossary.magento.com/widget) source is [lib/web/mage/tabs.js].
@@ -22,7 +20,7 @@ $("#element").tabs();
 Where:
 -   `#element` is the selector of the element for tabs is initialized.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.2/javascript-dev-guide/widgets/widget_toggle.md b/guides/v2.2/javascript-dev-guide/widgets/widget_toggle.md
index 491cd0d2f12..c3e9b587eb4 100644
--- a/guides/v2.2/javascript-dev-guide/widgets/widget_toggle.md
+++ b/guides/v2.2/javascript-dev-guide/widgets/widget_toggle.md
@@ -5,8 +5,6 @@ contributor_name: Atwix
 contributor_link: https://www.atwix.com/
 ---
 
-## Overview
-
 Use the ToggleAdvanced [widget](https://glossary.magento.com/widget/) to toggle the HTML class for selectors by clicking on a toggle element.
 
 The widget also allows toggling a clicked element class and clicked element text if an element is toggled.
@@ -26,7 +24,7 @@ $("#element").toggleAdvanced();
 Where:
 -   `#element` is the selector of the element for which ToggleAdvanced is initialized.
 
-Phtml template file examples using script:
+The following example shows a PHTML file using the script:
 
 ```html
 <script>
diff --git a/guides/v2.3/javascript-dev-guide/widgets/widget_calendar.md b/guides/v2.3/javascript-dev-guide/widgets/widget_calendar.md
index 2e2ca26589a..37b4e678c9f 100644
--- a/guides/v2.3/javascript-dev-guide/widgets/widget_calendar.md
+++ b/guides/v2.3/javascript-dev-guide/widgets/widget_calendar.md
@@ -4,8 +4,6 @@ subgroup: 3_Widgets
 title: Calendar widget
 ---
 
-## Overview {#fedg_jquery-widget_calendar-overview}
-
 The Calendar widget is a customized jQuery [Datepicker Widget] that enables selecting a data using a pop-up or an in-line calendar. Calendar is also responsible for:
 
 *	Merging the [global configuration] with the options that are passed from PHP when Calendar is initialized.
@@ -51,4 +49,4 @@ Most options, methods, and events for the calendar widget correspond to the jQue
 [global configuration]: #fedg_calendar_config
 [lib/web/mage/calendar.js]: {{ site.mage2bloburl }}/{{ page.guide_version }}/lib/web/mage/calendar.js
 [Initialize JavaScript]: {{page.baseurl}}/javascript-dev-guide/javascript/js_init.html
-[Datepicker Widget]: http://api.jqueryui.com/datepicker/
\ No newline at end of file
+[Datepicker Widget]: http://api.jqueryui.com/datepicker/