Documentattion: Fix asciidocs headings H1 (#10883)

documentation/articles/AddingJPAToTheAddressBookDemo.asciidoc

 ---
 
 [[adding-jpa-to-the-address-book-demo]]
-Adding JPA to the address book demo
------------------------------------
+= Adding JPA to the address book demo
 
 Petter Holmström
 

documentation/articles/AutoGeneratingAFormBasedOnABeanVaadin6StyleForm.asciidoc

 ---
 
 [[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

documentation/articles/BuildingVaadinApplicationsOnTopOfActiviti.asciidoc

 ---
 
 [[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
 

documentation/articles/ChangingTheDefaultConvertersForAnApplication.asciidoc

 ---
 
 [[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

documentation/articles/ConfiguringGridColumnWidths.asciidoc

 ---
 
 [[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

documentation/articles/CreatingABasicApplication.asciidoc

 ---
 
 [[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

documentation/articles/CreatingACustomFieldForEditingTheAddressOfAPerson.asciidoc

 ---
 
 [[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

documentation/articles/CreatingAMasterDetailsViewForEditingPersons.asciidoc

 ---
 
 [[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

documentation/articles/CreatingAReusableVaadinThemeInEclipse.asciidoc

 ---
 
 [[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.

documentation/articles/CreatingATextFieldForIntegerOnlyInputUsingADataSource.asciidoc

 ---
 
 [[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

documentation/articles/CreatingATextFieldForIntegerOnlyInputWhenNotUsingADataSource.asciidoc

 ---
 
 [[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

documentation/articles/CreatingAnApplicationWithDifferentFeaturesForDifferentClients.asciidoc

 ---
 
 [[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.

documentation/articles/CreatingYourOwnConverterForString.asciidoc

 ---
 
 [[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

documentation/articles/FindingTheCurrentRootAndApplication.asciidoc

 ---
 
 [[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

documentation/articles/FormattingDataInGrid.asciidoc

 ---
 
 [[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

documentation/articles/JMeterTesting.asciidoc

 ---
 
 [[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].

documentation/articles/JasperReportsOnVaadinSample.asciidoc

 ---
 
 [[jasper-reports-on-vaadin-sample]]
-Jasper reports on Vaadin sample
-------------------------------
+= Jasper reports on Vaadin sample
 
 [[introduction]]
 Introduction

documentation/articles/LazyQueryContainer.asciidoc

 ---
 
 [[lazy-query-container]]
-Lazy query container
---------------------
+= Lazy query container
 
 [[when-to-use-lazy-query-container]]
 When to Use Lazy Query Container?

documentation/articles/MigratingFromVaadin6ToVaadin7.asciidoc

 ---
 
 [[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

documentation/articles/MigratingFromVaadin7.0ToVaadin7.1.asciidoc

 ---
 
 [[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.
 

documentation/articles/OfflineModeForTouchKit4MobileApps.asciidoc

 ---
 
 [[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]._#

documentation/articles/ScalaAndVaadinHOWTO.asciidoc

 ---
 
 [[scala-and-vaadin-how-to]]
-Scala and Vaadin how-to
------------------------
+= Scala and Vaadin how-to
 
 [[introduction]]
 Introduction

documentation/articles/ShowingDataInGrid.asciidoc

 ---
 
 [[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

documentation/articles/ShowingExtraDataForGridRows.asciidoc

 ---
 
 [[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

documentation/articles/SimplifiedRPCusingJavaScript.asciidoc

 ---
 
 [[simplified-rpc-using-javascript]]
-Simplified RPC using JavaScript
--------------------------------
+= Simplified RPC using JavaScript
 
 This tutorial continues where
 link:IntegratingAJavaScriptComponent.asciidoc[Integrating a JavaScript

documentation/articles/UsingGridWithAContainer.asciidoc

 ---
 
 [[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

documentation/articles/UsingGridWithInlineData.asciidoc

 ---
 
 [[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],

documentation/articles/UsingHibernateWithVaadin.asciidoc

 ---
 
 [[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]

documentation/articles/UsingJDBCwithLazyQueryContainerAndFilteringTable.asciidoc

 ---
 
 [[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
 

documentation/articles/UsingPhoneGapBuildWithVaadinTouchKit.asciidoc

 ---
 
 [[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]._#

documentation/articles/UsingPython.asciidoc

 ---
 
 [[developing-vaadin-apps-with-python]]
-Developing Vaadin apps with Python
-----------------------------------
+= Developing Vaadin apps with Python
 
 [[to-accomplish-exactly-what]]
 To accomplish exactly what?

documentation/articles/UsingVaadinInAnExistingGWTProject.asciidoc

 ---
 
 [[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

documentation/articles/VAccessControl.asciidoc

 ---
 
 [[v-access-control]]
-Access control
---------------
+= Access control
 
 In this tutorial we will look into access control.
 

documentation/articles/Vaadin7HierarchicalContainerAndTreeComponentExampleWithLiferayOrganizationService.asciidoc

 ---
 
 [[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