Documentattion: Fix asciidocs headings H1 (#10883)

34 files changed, 34 insertions, 68 deletions

diff --git a/documentation/articles/AddingJPAToTheAddressBookDemo.asciidoc b/documentation/articles/AddingJPAToTheAddressBookDemo.asciidoc
index be0198f005..d48e199120 100644
--- a/documentation/articles/AddingJPAToTheAddressBookDemo.asciidoc
+++ b/documentation/articles/AddingJPAToTheAddressBookDemo.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[adding-jpa-to-the-address-book-demo]]
-Adding JPA to the address book demo
------------------------------------
+= Adding JPA to the address book demo
 
 Petter Holmström
 
diff --git a/documentation/articles/AutoGeneratingAFormBasedOnABeanVaadin6StyleForm.asciidoc b/documentation/articles/AutoGeneratingAFormBasedOnABeanVaadin6StyleForm.asciidoc
index f9f83ee693..3449b9ca8a 100644
--- a/documentation/articles/AutoGeneratingAFormBasedOnABeanVaadin6StyleForm.asciidoc
+++ b/documentation/articles/AutoGeneratingAFormBasedOnABeanVaadin6StyleForm.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[auto-generating-a-form-based-on-a-bean-vaadin-6-style-form]]
-Auto-generating a form based on a bean - Vaadin 6 style Form
-------------------------------------------------------------
+= Auto-generating a form based on a bean - Vaadin 6 style Form
 
 In Vaadin 6 it is easy to get a completely auto generated form based on
 a bean instance by creating a `BeanItem` and passing that to a Form. Using
diff --git a/documentation/articles/BuildingVaadinApplicationsOnTopOfActiviti.asciidoc b/documentation/articles/BuildingVaadinApplicationsOnTopOfActiviti.asciidoc
index 42ad9b44a7..dfb22c343e 100644
--- a/documentation/articles/BuildingVaadinApplicationsOnTopOfActiviti.asciidoc
+++ b/documentation/articles/BuildingVaadinApplicationsOnTopOfActiviti.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[building-vaadin-applications-on-top-of-activiti]]
-Building Vaadin applications on top of Activiti
------------------------------------------------
+= Building Vaadin applications on top of Activiti
 
 by Petter Holmström
 
diff --git a/documentation/articles/ChangingTheDefaultConvertersForAnApplication.asciidoc b/documentation/articles/ChangingTheDefaultConvertersForAnApplication.asciidoc
index c81abb378a..351ebb405e 100644
--- a/documentation/articles/ChangingTheDefaultConvertersForAnApplication.asciidoc
+++ b/documentation/articles/ChangingTheDefaultConvertersForAnApplication.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[changing-the-default-converters-for-an-application]]
-Changing the default converters for an application
---------------------------------------------------
+= Changing the default converters for an application
 
 Each Vaadin session instance has a `ConverterFactory` that provides
 converters to Fields and Table. The defaults might not be ideal for your
diff --git a/documentation/articles/ConfiguringGridColumnWidths.asciidoc b/documentation/articles/ConfiguringGridColumnWidths.asciidoc
index 0e41e5b358..d6be0e4f0b 100644
--- a/documentation/articles/ConfiguringGridColumnWidths.asciidoc
+++ b/documentation/articles/ConfiguringGridColumnWidths.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[configuring-grid-column-widths]]
-Configuring Grid column widths
-------------------------------
+= Configuring Grid column widths
 
 To try out how the widths of Grid columns work in different situations,
 we'll use the same base implementation as in the
diff --git a/documentation/articles/CreatingABasicApplication.asciidoc b/documentation/articles/CreatingABasicApplication.asciidoc
index c04dd314c6..cedb3bff65 100644
--- a/documentation/articles/CreatingABasicApplication.asciidoc
+++ b/documentation/articles/CreatingABasicApplication.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-basic-application]]
-Creating a basic application
-----------------------------
+= Creating a basic application
 
 To create a Vaadin application you need two files. A class that extends
 UI which is your main view and entry point to the application as well as
diff --git a/documentation/articles/CreatingACustomFieldForEditingTheAddressOfAPerson.asciidoc b/documentation/articles/CreatingACustomFieldForEditingTheAddressOfAPerson.asciidoc
index 1c623e44a5..e28f5e3e19 100644
--- a/documentation/articles/CreatingACustomFieldForEditingTheAddressOfAPerson.asciidoc
+++ b/documentation/articles/CreatingACustomFieldForEditingTheAddressOfAPerson.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-customfield-for-editing-the-address-of-a-person]]
-Creating a CustomField for editing the address of a person
-----------------------------------------------------------
+= Creating a CustomField for editing the address of a person
 
 A normal use case is that you want to create a form out a bean that the
 user can edit. Often these beans contain references to other beans as
diff --git a/documentation/articles/CreatingAMasterDetailsViewForEditingPersons.asciidoc b/documentation/articles/CreatingAMasterDetailsViewForEditingPersons.asciidoc
index 656a41f6fa..cb59904930 100644
--- a/documentation/articles/CreatingAMasterDetailsViewForEditingPersons.asciidoc
+++ b/documentation/articles/CreatingAMasterDetailsViewForEditingPersons.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-master-details-view-for-editing-persons]]
-Creating a master details view for editing persons
---------------------------------------------------
+= Creating a master details view for editing persons
 
 [[set-up]]
 Set-up
diff --git a/documentation/articles/CreatingAReusableVaadinThemeInEclipse.asciidoc b/documentation/articles/CreatingAReusableVaadinThemeInEclipse.asciidoc
index a669c8c302..4a235f151f 100644
--- a/documentation/articles/CreatingAReusableVaadinThemeInEclipse.asciidoc
+++ b/documentation/articles/CreatingAReusableVaadinThemeInEclipse.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-reusable-vaadin-theme-in-eclipse]]
-Creating a reusable Vaadin theme in Eclipse
--------------------------------------------
+= Creating a reusable Vaadin theme in Eclipse
 
 This tutorial teaches you how to create a standalone Vaadin theme that
 can be reused in other Vaadin projects as an add-on.
diff --git a/documentation/articles/CreatingATextFieldForIntegerOnlyInputUsingADataSource.asciidoc b/documentation/articles/CreatingATextFieldForIntegerOnlyInputUsingADataSource.asciidoc
index 7ad8784fe1..f1e6a9bedb 100644
--- a/documentation/articles/CreatingATextFieldForIntegerOnlyInputUsingADataSource.asciidoc
+++ b/documentation/articles/CreatingATextFieldForIntegerOnlyInputUsingADataSource.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-textfield-for-integer-only-input-using-a-data-source]]
-Creating a TextField for integer only input using a data source
----------------------------------------------------------------
+= Creating a TextField for integer only input using a data source
 
 A `TextField` is a component that always has a value of type `String`. When
 binding a property of another type to a text field, the value is
diff --git a/documentation/articles/CreatingATextFieldForIntegerOnlyInputWhenNotUsingADataSource.asciidoc b/documentation/articles/CreatingATextFieldForIntegerOnlyInputWhenNotUsingADataSource.asciidoc
index a0de80cc09..6082545f21 100644
--- a/documentation/articles/CreatingATextFieldForIntegerOnlyInputWhenNotUsingADataSource.asciidoc
+++ b/documentation/articles/CreatingATextFieldForIntegerOnlyInputWhenNotUsingADataSource.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-textfield-for-integer-only-input-when-not-using-a-data-source]]
-Creating a TextField for integer only input when not using a data source
-------------------------------------------------------------------------
+= Creating a TextField for integer only input when not using a data source
 
 A `TextField` is a component that always has a value of type `String`. By
 adding a converter to a field, the field will automatically validate
diff --git a/documentation/articles/CreatingAnApplicationWithDifferentFeaturesForDifferentClients.asciidoc b/documentation/articles/CreatingAnApplicationWithDifferentFeaturesForDifferentClients.asciidoc
index 7fb47f1423..f05ac3a269 100644
--- a/documentation/articles/CreatingAnApplicationWithDifferentFeaturesForDifferentClients.asciidoc
+++ b/documentation/articles/CreatingAnApplicationWithDifferentFeaturesForDifferentClients.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-an-application-with-different-features-for-different-clients]]
-Creating an application with different features for different clients
----------------------------------------------------------------------
+= Creating an application with different features for different clients
 
 Providing different features for different clients can be done by
 creating a specialized UIProvider for the application.
diff --git a/documentation/articles/CreatingYourOwnConverterForString.asciidoc b/documentation/articles/CreatingYourOwnConverterForString.asciidoc
index 2c1613d86b..3cb98e81fa 100644
--- a/documentation/articles/CreatingYourOwnConverterForString.asciidoc
+++ b/documentation/articles/CreatingYourOwnConverterForString.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-your-own-converter-for-string-mytype-conversion]]
-Creating your own converter for String - MyType conversion
-----------------------------------------------------------
+= Creating your own converter for String - MyType conversion
 
 If you have custom types that you want to represent using the built in
 field components, you can easily create your own converter to take care
diff --git a/documentation/articles/FindingTheCurrentRootAndApplication.asciidoc b/documentation/articles/FindingTheCurrentRootAndApplication.asciidoc
index f151b5b07f..c00f22c934 100644
--- a/documentation/articles/FindingTheCurrentRootAndApplication.asciidoc
+++ b/documentation/articles/FindingTheCurrentRootAndApplication.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[finding-the-current-root-and-application]]
-Finding the current root and application
-----------------------------------------
+= Finding the current root and application
 
 There are many cases where you need a reference to the active
 `Application` or `Root`, for instance for showing notifications in a click
diff --git a/documentation/articles/FormattingDataInGrid.asciidoc b/documentation/articles/FormattingDataInGrid.asciidoc
index 1327cc0c65..35a41e8225 100644
--- a/documentation/articles/FormattingDataInGrid.asciidoc
+++ b/documentation/articles/FormattingDataInGrid.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[formatting-data-in-grid]]
-Formatting data in grid
------------------------
+= Formatting data in grid
 
 Without any special configuration, Grid tries to find a `Converter` for
 converting the property value into a String that can be shown in the
diff --git a/documentation/articles/JMeterTesting.asciidoc b/documentation/articles/JMeterTesting.asciidoc
index fe9757951d..5f08d6f455 100644
--- a/documentation/articles/JMeterTesting.asciidoc
+++ b/documentation/articles/JMeterTesting.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[how-to-test-vaadin-web-application-performance-with-jmeter]]
-How to test Vaadin web application performance with JMeter
-----------------------------------------------------------
+= How to test Vaadin web application performance with JMeter
 
 This article describes how to make load testing of your Vaadin web
 application with http://jakarta.apache.org/jmeter/[JMeter].
diff --git a/documentation/articles/JasperReportsOnVaadinSample.asciidoc b/documentation/articles/JasperReportsOnVaadinSample.asciidoc
index ab38bfef62..52fff5a964 100644
--- a/documentation/articles/JasperReportsOnVaadinSample.asciidoc
+++ b/documentation/articles/JasperReportsOnVaadinSample.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[jasper-reports-on-vaadin-sample]]
-Jasper reports on Vaadin sample
-------------------------------
+= Jasper reports on Vaadin sample
 
 [[introduction]]
 Introduction
diff --git a/documentation/articles/LazyQueryContainer.asciidoc b/documentation/articles/LazyQueryContainer.asciidoc
index d6f1a2285b..5728fe96ae 100644
--- a/documentation/articles/LazyQueryContainer.asciidoc
+++ b/documentation/articles/LazyQueryContainer.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[lazy-query-container]]
-Lazy query container
---------------------
+= Lazy query container
 
 [[when-to-use-lazy-query-container]]
 When to Use Lazy Query Container?
diff --git a/documentation/articles/MigratingFromVaadin6ToVaadin7.asciidoc b/documentation/articles/MigratingFromVaadin6ToVaadin7.asciidoc
index ca566a5e92..de3e9f5d24 100644
--- a/documentation/articles/MigratingFromVaadin6ToVaadin7.asciidoc
+++ b/documentation/articles/MigratingFromVaadin6ToVaadin7.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[migrating-from-vaadin-6-to-vaadin-7]]
-Migrating from Vaadin 6 to Vaadin 7
------------------------------------
+= Migrating from Vaadin 6 to Vaadin 7
 
 For migration to Vaadin 7.1,  see
 link:MigratingFromVaadin7.0ToVaadin7.1.asciidoc[Migrating
diff --git a/documentation/articles/MigratingFromVaadin7.0ToVaadin7.1.asciidoc b/documentation/articles/MigratingFromVaadin7.0ToVaadin7.1.asciidoc
index 09b4c3cc16..ecd244a675 100644
--- a/documentation/articles/MigratingFromVaadin7.0ToVaadin7.1.asciidoc
+++ b/documentation/articles/MigratingFromVaadin7.0ToVaadin7.1.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[migrating-from-vaadin-7.0-to-vaadin-7.1]]
-Migrating from Vaadin 7.0 to Vaadin 7.1
----------------------------------------
+= Migrating from Vaadin 7.0 to Vaadin 7.1
 
 This guide describes how to migrate from earlier versions to Vaadin 7.1.
 
diff --git a/documentation/articles/OfflineModeForTouchKit4MobileApps.asciidoc b/documentation/articles/OfflineModeForTouchKit4MobileApps.asciidoc
index d9f229ffd1..98182ee6e3 100644
--- a/documentation/articles/OfflineModeForTouchKit4MobileApps.asciidoc
+++ b/documentation/articles/OfflineModeForTouchKit4MobileApps.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[offline-mode-for-touchkit-4-mobile-apps]]
-Offline mode for TouchKit 4 mobile apps
----------------------------------------
+= Offline mode for TouchKit 4 mobile apps
 
 [.underline]#*_Note:_* _Vaadin Touchkit has been discontinued. A community-supported version is
 available https://github.com/parttio/touchkit[on GitHub]._#
diff --git a/documentation/articles/ScalaAndVaadinHOWTO.asciidoc b/documentation/articles/ScalaAndVaadinHOWTO.asciidoc
index 1799dfd760..94740b1cb5 100644
--- a/documentation/articles/ScalaAndVaadinHOWTO.asciidoc
+++ b/documentation/articles/ScalaAndVaadinHOWTO.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[scala-and-vaadin-how-to]]
-Scala and Vaadin how-to
------------------------
+= Scala and Vaadin how-to
 
 [[introduction]]
 Introduction
diff --git a/documentation/articles/ShowingDataInGrid.asciidoc b/documentation/articles/ShowingDataInGrid.asciidoc
index d6a28b733c..275d97e766 100644
--- a/documentation/articles/ShowingDataInGrid.asciidoc
+++ b/documentation/articles/ShowingDataInGrid.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[showing-data-in-grid]]
-Showing data in Grid
---------------------
+= Showing data in Grid
 
 Grid lazy-loads data from a `Container` instance. There are different
 container implementations that e.g. fetch data from a database or use a
diff --git a/documentation/articles/ShowingExtraDataForGridRows.asciidoc b/documentation/articles/ShowingExtraDataForGridRows.asciidoc
index f69508d5c7..a5c12fa995 100644
--- a/documentation/articles/ShowingExtraDataForGridRows.asciidoc
+++ b/documentation/articles/ShowingExtraDataForGridRows.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[showing-extra-data-for-grid-rows]]
-Showing extra data for Grid rows
---------------------------------
+= Showing extra data for Grid rows
 
 Some data might not be suitable to be shown as part of a regular Grid,
 e.g. because it's too large to fit into a Grid cell or because it's
diff --git a/documentation/articles/SimplifiedRPCusingJavaScript.asciidoc b/documentation/articles/SimplifiedRPCusingJavaScript.asciidoc
index efcfb6cc74..64d3ea5b1c 100644
--- a/documentation/articles/SimplifiedRPCusingJavaScript.asciidoc
+++ b/documentation/articles/SimplifiedRPCusingJavaScript.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[simplified-rpc-using-javascript]]
-Simplified RPC using JavaScript
--------------------------------
+= Simplified RPC using JavaScript
 
 This tutorial continues where
 link:IntegratingAJavaScriptComponent.asciidoc[Integrating a JavaScript
diff --git a/documentation/articles/UsingGridWithAContainer.asciidoc b/documentation/articles/UsingGridWithAContainer.asciidoc
index a3eb58f461..ab268c40a3 100644
--- a/documentation/articles/UsingGridWithAContainer.asciidoc
+++ b/documentation/articles/UsingGridWithAContainer.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-grid-with-a-container]]
-Using Grid with a Container
----------------------------
+= Using Grid with a Container
 
 Grid lazy-loads data from a `Container` instance. There are different
 container implementations that e.g. fetch data from a database or use a
diff --git a/documentation/articles/UsingGridWithInlineData.asciidoc b/documentation/articles/UsingGridWithInlineData.asciidoc
index cfb1b51af9..2bc08a9910 100644
--- a/documentation/articles/UsingGridWithInlineData.asciidoc
+++ b/documentation/articles/UsingGridWithInlineData.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-grid-with-inline-data]]
-Using Grid with inline data
----------------------------
+= Using Grid with inline data
 
 Instead of using a Vaadin Container as explained in
 link:UsingGridWithAContainer.asciidoc[Using Grid with a Container],
diff --git a/documentation/articles/UsingHibernateWithVaadin.asciidoc b/documentation/articles/UsingHibernateWithVaadin.asciidoc
index 46394b46f9..b33bf50cc6 100644
--- a/documentation/articles/UsingHibernateWithVaadin.asciidoc
+++ b/documentation/articles/UsingHibernateWithVaadin.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-hibernate-with-vaadin]]
-Using Hibernate with Vaadin
----------------------------
+= Using Hibernate with Vaadin
 
 Using Hibernate in Toolkit application, Basic
 http://en.wikipedia.org/wiki/Create,_read,_update_and_delete[CRUD]
diff --git a/documentation/articles/UsingJDBCwithLazyQueryContainerAndFilteringTable.asciidoc b/documentation/articles/UsingJDBCwithLazyQueryContainerAndFilteringTable.asciidoc
index 09be51b867..940667a333 100644
--- a/documentation/articles/UsingJDBCwithLazyQueryContainerAndFilteringTable.asciidoc
+++ b/documentation/articles/UsingJDBCwithLazyQueryContainerAndFilteringTable.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-jdbc-with-lazy-query-container-and-filteringtable]]
-Using JDBC with Lazy Query Container and FilteringTable
--------------------------------------------------------
+= Using JDBC with Lazy Query Container and FilteringTable
 
 Introduction
 
diff --git a/documentation/articles/UsingPhoneGapBuildWithVaadinTouchKit.asciidoc b/documentation/articles/UsingPhoneGapBuildWithVaadinTouchKit.asciidoc
index 4b848ec08e..24d9e497ac 100644
--- a/documentation/articles/UsingPhoneGapBuildWithVaadinTouchKit.asciidoc
+++ b/documentation/articles/UsingPhoneGapBuildWithVaadinTouchKit.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-phonegap-build-with-vaadin-touchkit]]
-Using PhoneGap Build with Vaadin TouchKit
------------------------------------------
+= Using PhoneGap Build with Vaadin TouchKit
 
 [.underline]#*_Note:_* _Vaadin Touchkit has been discontinued. A community-supported version is
 available https://github.com/parttio/touchkit[on GitHub]._#
diff --git a/documentation/articles/UsingPython.asciidoc b/documentation/articles/UsingPython.asciidoc
index 374225c4e1..506cbca0eb 100644
--- a/documentation/articles/UsingPython.asciidoc
+++ b/documentation/articles/UsingPython.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[developing-vaadin-apps-with-python]]
-Developing Vaadin apps with Python
-----------------------------------
+= Developing Vaadin apps with Python
 
 [[to-accomplish-exactly-what]]
 To accomplish exactly what?
diff --git a/documentation/articles/UsingVaadinInAnExistingGWTProject.asciidoc b/documentation/articles/UsingVaadinInAnExistingGWTProject.asciidoc
index 879db8cdf4..4e36cfdbca 100644
--- a/documentation/articles/UsingVaadinInAnExistingGWTProject.asciidoc
+++ b/documentation/articles/UsingVaadinInAnExistingGWTProject.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-vaadin-in-an-existing-gwt-project]]
-Using Vaadin in an existing GWT project
----------------------------------------
+= Using Vaadin in an existing GWT project
 
 [[using-vaadin-jar-with-google-eclipse-plugin-in-a-gwt-project]]
 Using Vaadin JAR with Google Eclipse plugin in a GWT project
diff --git a/documentation/articles/VAccessControl.asciidoc b/documentation/articles/VAccessControl.asciidoc
index 308e64d569..a2f230316b 100644
--- a/documentation/articles/VAccessControl.asciidoc
+++ b/documentation/articles/VAccessControl.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[v-access-control]]
-Access control
---------------
+= Access control
 
 In this tutorial we will look into access control.
 
diff --git a/documentation/articles/Vaadin7HierarchicalContainerAndTreeComponentExampleWithLiferayOrganizationService.asciidoc b/documentation/articles/Vaadin7HierarchicalContainerAndTreeComponentExampleWithLiferayOrganizationService.asciidoc
index 0bb54c23c0..db607c9552 100644
--- a/documentation/articles/Vaadin7HierarchicalContainerAndTreeComponentExampleWithLiferayOrganizationService.asciidoc
+++ b/documentation/articles/Vaadin7HierarchicalContainerAndTreeComponentExampleWithLiferayOrganizationService.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-7-hierarchical-container-and-treecomponent-example-with-liferay-organizationservice]]
-Vaadin 7 hierarchical container and TreeComponent example with Liferay OrganizationService
-------------------------------------------------------------------------------------------
+= Vaadin 7 hierarchical container and TreeComponent example with Liferay OrganizationService
 
 I recently needed a portlet to display the Organizations/Locations a
 user belongs to in a Hierarchical Tree.  I used Vaadin's tree and