Fix asciidocs headings H1

84 files changed, 84 insertions, 167 deletions

diff --git a/documentation/articles/AccessControlForViews.asciidoc b/documentation/articles/AccessControlForViews.asciidoc
index f7621013eb..b97de78a30 100644
--- a/documentation/articles/AccessControlForViews.asciidoc
+++ b/documentation/articles/AccessControlForViews.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[access-control-for-views]]
-Access control for views
-------------------------
+= Access control for views
 
 The Navigator API provides a simple mechanism to allow or disallow
 navigating to a View. Before a View is shown, each ViewChangeListener
diff --git a/documentation/articles/AccessingWebPageAndBrowserInformation.asciidoc b/documentation/articles/AccessingWebPageAndBrowserInformation.asciidoc
index 18c98b7aa4..7f67ac886c 100644
--- a/documentation/articles/AccessingWebPageAndBrowserInformation.asciidoc
+++ b/documentation/articles/AccessingWebPageAndBrowserInformation.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[accessing-web-page-and-browser-information]]
-Accessing web page and browser information
-------------------------------------------
+= Accessing web page and browser information
 
 Vaadin 7 includes a new *Page* class offering access to various
 client-side information and events concerning the web page and browser
diff --git a/documentation/articles/AddingASplashScreen.asciidoc b/documentation/articles/AddingASplashScreen.asciidoc
index 8f424b774a..54d8a00dda 100644
--- a/documentation/articles/AddingASplashScreen.asciidoc
+++ b/documentation/articles/AddingASplashScreen.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[adding-a-splash-sreen]]
-Adding a splash screen
-----------------------
+= Adding a splash screen
 
 When a Vaadin application is loading a loading indicator is
 automatically shown so the user knows something is happening. But what
diff --git a/documentation/articles/BroadcastingMessagesToOtherUsers.asciidoc b/documentation/articles/BroadcastingMessagesToOtherUsers.asciidoc
index 66e16c64a1..7a0e1e3a21 100644
--- a/documentation/articles/BroadcastingMessagesToOtherUsers.asciidoc
+++ b/documentation/articles/BroadcastingMessagesToOtherUsers.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[broadcasting-messages-to-other-users]]
-Broadcasting messages to other users
-------------------------------------
+= Broadcasting messages to other users
 
 In this tutorial we will create an application where any user can send a
 broadcast message to all other active users. We will start from a
diff --git a/documentation/articles/ChangingThemeOnTheFly.asciidoc b/documentation/articles/ChangingThemeOnTheFly.asciidoc
index d7f124e2db..2708975b38 100644
--- a/documentation/articles/ChangingThemeOnTheFly.asciidoc
+++ b/documentation/articles/ChangingThemeOnTheFly.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[changing-theme-on-the-fly]]
-Changing theme on the fly
--------------------------
+= Changing theme on the fly
 
 Starting from Vaadin 7.3, you can change themes in the application
 without reloading the page. To do this, simply use the
diff --git a/documentation/articles/ChooseInputFieldComponentsWisely.asciidoc b/documentation/articles/ChooseInputFieldComponentsWisely.asciidoc
index 8f9f49a7d5..f2f5b94f98 100644
--- a/documentation/articles/ChooseInputFieldComponentsWisely.asciidoc
+++ b/documentation/articles/ChooseInputFieldComponentsWisely.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[choosing-input-field-components-wisely]]
-Choosing input field components wisely
---------------------------------------
+= Choosing input field components wisely
 
 The core Vaadin framework has more than ten different input field
 components. Choosing the right one can improve your application’s
diff --git a/documentation/articles/CleaningUpResourcesInAUI.asciidoc b/documentation/articles/CleaningUpResourcesInAUI.asciidoc
index 2357dadbdc..af33e9c122 100644
--- a/documentation/articles/CleaningUpResourcesInAUI.asciidoc
+++ b/documentation/articles/CleaningUpResourcesInAUI.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[cleaning-up-resources-in-a-ui]]
-Cleaning up resources in a UI
------------------------------
+= Cleaning up resources in a UI
 
 Vaadin UIs that are open on the client side send a regular heartbeat
 to the server to indicate they are still alive, even though there is no
diff --git a/documentation/articles/ComponentAddonProjectSetupHOWTO.asciidoc b/documentation/articles/ComponentAddonProjectSetupHOWTO.asciidoc
index e8d063e27c..d4a04163fa 100644
--- a/documentation/articles/ComponentAddonProjectSetupHOWTO.asciidoc
+++ b/documentation/articles/ComponentAddonProjectSetupHOWTO.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[component-add-on-project-setup-howto]]
-Component add-on project setup how-to
-------------------------------------
+= Component add-on project setup how-to
 
 This how-to walks you through a complete setup for a project for
 developing, building and publishing your own Vaadin UI component
diff --git a/documentation/articles/ConfigureComboBoxesWisely.asciidoc b/documentation/articles/ConfigureComboBoxesWisely.asciidoc
index c2cf7ff922..fabc9b7353 100644
--- a/documentation/articles/ConfigureComboBoxesWisely.asciidoc
+++ b/documentation/articles/ConfigureComboBoxesWisely.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[configure-comboboxes-wisely]]
-Configure ComboBoxes wisely
----------------------------
+= Configure ComboBoxes wisely
 The Vaadin *ComboBox* is a versatile input field with lots of settings
 that change its behavior. The default settings are a good start, but are
 not necessarily suitable for all situations. Configure your ComboBoxes
diff --git a/documentation/articles/ConfigureInputFieldsToGuideDataEntry.asciidoc b/documentation/articles/ConfigureInputFieldsToGuideDataEntry.asciidoc
index cb08a16951..78e2074a81 100644
--- a/documentation/articles/ConfigureInputFieldsToGuideDataEntry.asciidoc
+++ b/documentation/articles/ConfigureInputFieldsToGuideDataEntry.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[configure-input-fields-to-guide-data-entry]]
-Configure input fields to guide data entry
-------------------------------------------
+= Configure input fields to guide data entry
 
 [[field-size]]
 Field size
diff --git a/documentation/articles/ConfiguringPushForYourEnvironment.asciidoc b/documentation/articles/ConfiguringPushForYourEnvironment.asciidoc
index 4237f926d7..f501e92b55 100644
--- a/documentation/articles/ConfiguringPushForYourEnvironment.asciidoc
+++ b/documentation/articles/ConfiguringPushForYourEnvironment.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[configuring-push-for-your-environment]]
-Configuring push for your environment
--------------------------------------
+= Configuring push for your environment
 
 Server push and especially websockets are emerging technologies and not
 all servers and browsers handle them correctly (or even close to
diff --git a/documentation/articles/CreatingABookmarkableApplicationWithBackButtonSupport.asciidoc b/documentation/articles/CreatingABookmarkableApplicationWithBackButtonSupport.asciidoc
index 9a68687422..52dd8ef093 100644
--- a/documentation/articles/CreatingABookmarkableApplicationWithBackButtonSupport.asciidoc
+++ b/documentation/articles/CreatingABookmarkableApplicationWithBackButtonSupport.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-bookmarkable-application-with-back-button-support]]
-Creating a bookmarkable application with back button support
-------------------------------------------------------------
+= Creating a bookmarkable application with back button support
 
 Vaadin 7 comes with a new set of APIs to aid creation of navigation
 within your application. The main concepts are *Navigator* and *View*,
diff --git a/documentation/articles/CreatingAComponentExtension.asciidoc b/documentation/articles/CreatingAComponentExtension.asciidoc
index 01476a9597..15c117ff11 100644
--- a/documentation/articles/CreatingAComponentExtension.asciidoc
+++ b/documentation/articles/CreatingAComponentExtension.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-component-extension]]
-Creating a component extension
-------------------------------
+= Creating a component extension
 
 In this tutorial we create a simple extension that can be attached to a
 `PasswordField`, displaying a floating notification if the user's Caps
diff --git a/documentation/articles/CreatingAServlet3.0Application.asciidoc b/documentation/articles/CreatingAServlet3.0Application.asciidoc
index da8814b03c..f91e46073f 100644
--- a/documentation/articles/CreatingAServlet3.0Application.asciidoc
+++ b/documentation/articles/CreatingAServlet3.0Application.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-servlet-3.0-application]]
-Creating a servlet 3.0 application
-----------------------------------
+= Creating a servlet 3.0 application
 
 Servlet 3.0 introduces a `@WebServlet` annotation which can be used to
 replace the traditional web.xml. The straightforward approach to create
diff --git a/documentation/articles/CreatingASimpleComponent.asciidoc b/documentation/articles/CreatingASimpleComponent.asciidoc
index ddbbf26663..a2665e72ed 100644
--- a/documentation/articles/CreatingASimpleComponent.asciidoc
+++ b/documentation/articles/CreatingASimpleComponent.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-simple-component]]
-Creating a simple component
----------------------------
+= Creating a simple component
 
 To make a component with a new client-side widget (as opposed to making
 a server-side composite), you will need to make three things: the
diff --git a/documentation/articles/CreatingASimpleComponentContainer.asciidoc b/documentation/articles/CreatingASimpleComponentContainer.asciidoc
index 7a94c85ec8..f02b5d0612 100644
--- a/documentation/articles/CreatingASimpleComponentContainer.asciidoc
+++ b/documentation/articles/CreatingASimpleComponentContainer.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-simple-component-container]]
-Creating a simple component container
--------------------------------------
+= Creating a simple component container
 
 Components in Vaadin can be roughly split into two groups, `Component`{empty}s
 and `ComponentContainer`{empty}s. ComponentContainers are Components in
diff --git a/documentation/articles/CreatingAThemeUsingSass.asciidoc b/documentation/articles/CreatingAThemeUsingSass.asciidoc
index 0b1babae76..e9236017fe 100644
--- a/documentation/articles/CreatingAThemeUsingSass.asciidoc
+++ b/documentation/articles/CreatingAThemeUsingSass.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-theme-using-sass]]
-Creating a theme using SASS
----------------------------
+= Creating a theme using SASS
 
 Vaadin 7 comes with built in support for Sass, which can be thought of
 as a preprocessor for CSS. From the Sass homepage:
diff --git a/documentation/articles/CreatingAUIExtension.asciidoc b/documentation/articles/CreatingAUIExtension.asciidoc
index 56e209ede7..2754e7e31d 100644
--- a/documentation/articles/CreatingAUIExtension.asciidoc
+++ b/documentation/articles/CreatingAUIExtension.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-a-ui-extension]]
-Creating a UI extension
------------------------
+= Creating a UI extension
 
 An *Extension* is an entity that is not a full-fledged UI component, but
 is instead used to enhance or extend the functionality of an existing
diff --git a/documentation/articles/CreatingAnApplicationThatPreservesStateOnRefresh.asciidoc b/documentation/articles/CreatingAnApplicationThatPreservesStateOnRefresh.asciidoc
index 1226359d0a..669cd62fb8 100644
--- a/documentation/articles/CreatingAnApplicationThatPreservesStateOnRefresh.asciidoc
+++ b/documentation/articles/CreatingAnApplicationThatPreservesStateOnRefresh.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-an-application-that-preserves-state-on-refresh]]
-Creating an application that preserves state on refresh
--------------------------------------------------------
+= Creating an application that preserves state on refresh
 
 By default, Vaadin 7 does not preserve UI state when the browser page is
 refreshed. This means that the instance number in this example is
diff --git a/documentation/articles/CreatingAnEclipseProject.asciidoc b/documentation/articles/CreatingAnEclipseProject.asciidoc
index e487fec6c0..ec16ed7fe1 100644
--- a/documentation/articles/CreatingAnEclipseProject.asciidoc
+++ b/documentation/articles/CreatingAnEclipseProject.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-an-eclipse-project]]
-Creating an Eclipse project
----------------------------
+= Creating an Eclipse project
 
 At the moment you have two options:
 
diff --git a/documentation/articles/CreatingMultiTabApplications.asciidoc b/documentation/articles/CreatingMultiTabApplications.asciidoc
index 310df1c0f0..f4981f0233 100644
--- a/documentation/articles/CreatingMultiTabApplications.asciidoc
+++ b/documentation/articles/CreatingMultiTabApplications.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-multi-tab-applications]]
-Creating multi-tab applications
--------------------------------
+= Creating multi-tab applications
 
 Every new request to the server gets a new session and UI instance.
 Having the application open in separate tabs or windows means that the
diff --git a/documentation/articles/CreatingSecureVaadinApplicationsUsingJEE6.asciidoc b/documentation/articles/CreatingSecureVaadinApplicationsUsingJEE6.asciidoc
index 85904abde2..e032234abc 100644
--- a/documentation/articles/CreatingSecureVaadinApplicationsUsingJEE6.asciidoc
+++ b/documentation/articles/CreatingSecureVaadinApplicationsUsingJEE6.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[creating-secure-vaadin-applications-using-jee6]]
-Creating secure Vaadin applications using JEE6
-----------------------------------------------
+= Creating secure Vaadin applications using JEE6
 
 by Petter Holmström
 
diff --git a/documentation/articles/CustomizingComponentThemeWithSass.asciidoc b/documentation/articles/CustomizingComponentThemeWithSass.asciidoc
index ddef984832..754ff3250a 100644
--- a/documentation/articles/CustomizingComponentThemeWithSass.asciidoc
+++ b/documentation/articles/CustomizingComponentThemeWithSass.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[customizing-component-theme-with-sass]]
-Customizing component theme with SASS
--------------------------------------
+= Customizing component theme with SASS
 
 In addition to the general benefits Sass brings to the world of CSS in
 Vaadin 7, the way themes are set up allows us to quite easily accomplish
diff --git a/documentation/articles/CustomizingTheStartupPageInAnApplication.asciidoc b/documentation/articles/CustomizingTheStartupPageInAnApplication.asciidoc
index e1b4e7a09d..58ad8d08f9 100644
--- a/documentation/articles/CustomizingTheStartupPageInAnApplication.asciidoc
+++ b/documentation/articles/CustomizingTheStartupPageInAnApplication.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[customizing-the-startup-page-in-an-application]]
-Customizing the startup page in an application
-----------------------------------------------
+= Customizing the startup page in an application
 
 In Vaadin 6, the startup page - used to bootstrap a new Vaadin UI
 instance in the browser - was generated as a monolithic chunk of HTML
diff --git a/documentation/articles/DevelopingPortletsForTheWebSpherePortalServer.asciidoc b/documentation/articles/DevelopingPortletsForTheWebSpherePortalServer.asciidoc
index 6ddb12a746..7a934aa60b 100644
--- a/documentation/articles/DevelopingPortletsForTheWebSpherePortalServer.asciidoc
+++ b/documentation/articles/DevelopingPortletsForTheWebSpherePortalServer.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[developing-portlets-for-the-websphere-portal-server]]
-Developing portlets for the Websphere Portal Server
----------------------------------------------------
+= Developing portlets for the Websphere Portal Server
 
 When creating portlets for the Websphere Portal Server (aka WPS) you
 have the choice between different frameworks
diff --git a/documentation/articles/DynamicallyInjectingCSS.asciidoc b/documentation/articles/DynamicallyInjectingCSS.asciidoc
index 3b71ad3c2d..b8129f9a76 100644
--- a/documentation/articles/DynamicallyInjectingCSS.asciidoc
+++ b/documentation/articles/DynamicallyInjectingCSS.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[dynamically-injecting-css]]
-Dynamically injecting CSS
--------------------------
+= Dynamically injecting CSS
 
 In most cases you will style your components using SASS or CSS and
 create a theme for the application which you include with the `@Theme`
diff --git a/documentation/articles/DynamicallyUpdatingStateBeforeSendingChangesToClient.asciidoc b/documentation/articles/DynamicallyUpdatingStateBeforeSendingChangesToClient.asciidoc
index 66da45e74a..d0c93d31cf 100644
--- a/documentation/articles/DynamicallyUpdatingStateBeforeSendingChangesToClient.asciidoc
+++ b/documentation/articles/DynamicallyUpdatingStateBeforeSendingChangesToClient.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[dynamically-updating-state-before-sending-changes-to-client]]
-Dynamically updating state before sending changes to client
------------------------------------------------------------
+= Dynamically updating state before sending changes to client
 
 There are some cases where a server-side implementation must delay some
 work until right before data is about to be sent to the client. Some
diff --git a/documentation/articles/EnableAndDisableButtonsToIndicateState.asciidoc b/documentation/articles/EnableAndDisableButtonsToIndicateState.asciidoc
index 4acc90440b..e6ccb85621 100644
--- a/documentation/articles/EnableAndDisableButtonsToIndicateState.asciidoc
+++ b/documentation/articles/EnableAndDisableButtonsToIndicateState.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[enable-and-disable-buttons-to-indicate-state]]
-Enable and disable buttons to indicate state
---------------------------------------------
+= Enable and disable buttons to indicate state
 
 Most user interfaces have actions that can only be performed if certain
 conditions are met. In other cases, the actions can be performed at any
diff --git a/documentation/articles/EnablingServerPush.asciidoc b/documentation/articles/EnablingServerPush.asciidoc
index 79e424e4a5..99bd7dc844 100644
--- a/documentation/articles/EnablingServerPush.asciidoc
+++ b/documentation/articles/EnablingServerPush.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[enabling-server-push]]
-Enabling server push
---------------------
+= Enabling server push
 
 The traditional way of communication between client and server in Vaadin
 has been through XHR, i.e. AJAX requests. The client does a request to
diff --git a/documentation/articles/ExposingServerSideAPIToJavaScript.asciidoc b/documentation/articles/ExposingServerSideAPIToJavaScript.asciidoc
index 2af4c6d05f..7d996f357f 100644
--- a/documentation/articles/ExposingServerSideAPIToJavaScript.asciidoc
+++ b/documentation/articles/ExposingServerSideAPIToJavaScript.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[exposing-server-side-api-to-javascript]]
-Exposing server-side API to JavaScript
---------------------------------------
+= Exposing server-side API to JavaScript
 
 The new JavaScript integration functionality will allow you to easily
 publish methods that can be called with JavaScript on the client side.
diff --git a/documentation/articles/FindingTheCurrentUIAndPageAndVaadinSession.asciidoc b/documentation/articles/FindingTheCurrentUIAndPageAndVaadinSession.asciidoc
index e7685d3f6d..5d8778f261 100644
--- a/documentation/articles/FindingTheCurrentUIAndPageAndVaadinSession.asciidoc
+++ b/documentation/articles/FindingTheCurrentUIAndPageAndVaadinSession.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[finding-the-current-ui-and-page-and-vaadin-session]]
-Finding the current UI and page and vaadin session
---------------------------------------------------
+= Finding the current UI and page and vaadin session
 There are many cases where you need a reference to the active `UI`, `Page`
 or `VaadinServiceSession`, for instance for showing notifications in a
 click listener. It is possible to get a reference to the component from
diff --git a/documentation/articles/GeneratingDynamicResourcesBasedOnURIOrParameters.asciidoc b/documentation/articles/GeneratingDynamicResourcesBasedOnURIOrParameters.asciidoc
index 51f157eacd..eeb053f80c 100644
--- a/documentation/articles/GeneratingDynamicResourcesBasedOnURIOrParameters.asciidoc
+++ b/documentation/articles/GeneratingDynamicResourcesBasedOnURIOrParameters.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[generating-dynamic-resources-based-on-uri-or-parameters]]
-Generating dynamic resources based on URI or parameters
--------------------------------------------------------
+= Generating dynamic resources based on URI or parameters
 
 You can dynamically generate responses based on e.g. query parameters by
 creating your own `RequestHandler` and registering it with the session.
diff --git a/documentation/articles/GettingStartedOnNetBeans.asciidoc b/documentation/articles/GettingStartedOnNetBeans.asciidoc
index 37ccdede7d..1def121a4b 100644
--- a/documentation/articles/GettingStartedOnNetBeans.asciidoc
+++ b/documentation/articles/GettingStartedOnNetBeans.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[getting-started-on-netbeans]]
-Getting started on NetBeans
----------------------------
+= Getting started on NetBeans
 
 *This page is for old NetBeans version. Take a look at
 http://wiki.netbeans.org/VaadinPlugin1.0.0[New plugin in NetBeans wiki]*
diff --git a/documentation/articles/HandlingLogout.asciidoc b/documentation/articles/HandlingLogout.asciidoc
index 2ff850a19b..0ce052b71b 100644
--- a/documentation/articles/HandlingLogout.asciidoc
+++ b/documentation/articles/HandlingLogout.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[handling-logout]]
-Handling logout
----------------
+= Handling logout
 What should happen the user wants to log out from a Vaadin application
 depends on how the user is stored when the user logged in.
 
diff --git a/documentation/articles/IBGettingStartedWithVaadinSpringWithoutSpringBoot.asciidoc b/documentation/articles/IBGettingStartedWithVaadinSpringWithoutSpringBoot.asciidoc
index 09cc7a4de6..9ca2954ea3 100644
--- a/documentation/articles/IBGettingStartedWithVaadinSpringWithoutSpringBoot.asciidoc
+++ b/documentation/articles/IBGettingStartedWithVaadinSpringWithoutSpringBoot.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[i-b-getting-started-with-vaadin-spring-without-spring-boot]]
-I b - Getting started with Vaadin Spring without Spring Boot
-------------------------------------------------------------
+= I b - Getting started with Vaadin Spring without Spring Boot
 
 Note: this tutorial applies to *Vaadin Spring 1.0.0 and later*
 
diff --git a/documentation/articles/IIInjectionAndScopes.asciidoc b/documentation/articles/IIInjectionAndScopes.asciidoc
index f8aa692bd8..655bbd4345 100644
--- a/documentation/articles/IIInjectionAndScopes.asciidoc
+++ b/documentation/articles/IIInjectionAndScopes.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[ii-injection-and-scopes]]
-II - Injection and scopes
--------------------------
+= II - Injection and scopes
 
 In this tutorial we'll take a closer look at the @CDIUI annotation and
 use CDI to inject some beans to our application.
diff --git a/documentation/articles/IntegratingAJavaScriptComponent.asciidoc b/documentation/articles/IntegratingAJavaScriptComponent.asciidoc
index 3a2ae90526..aa5c9c4bfb 100644
--- a/documentation/articles/IntegratingAJavaScriptComponent.asciidoc
+++ b/documentation/articles/IntegratingAJavaScriptComponent.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[integrating-a-javascript-component]]
-Integrating a JavaScript component
-----------------------------------
+= Integrating a JavaScript component
 
 You can use an existing JavaScript component as a component in Vaadin by
 creating a server-side API for the component as well as writing the
diff --git a/documentation/articles/IntegratingAJavaScriptLibraryAsAnExtension.asciidoc b/documentation/articles/IntegratingAJavaScriptLibraryAsAnExtension.asciidoc
index f2fc35c9cb..dd00b9fc00 100644
--- a/documentation/articles/IntegratingAJavaScriptLibraryAsAnExtension.asciidoc
+++ b/documentation/articles/IntegratingAJavaScriptLibraryAsAnExtension.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[integrating-a-javascript-library-as-an-extension]]
-Integrating a JavaScript library as an extension
-------------------------------------------------
+= Integrating a JavaScript library as an extension
 
 JavaScript can also be used for creating Extensions e.g. for integrating
 existing JavaScript libraries. See link:CreatingAUIExtension.asciidoc[Creating a UI extension] for general information about Extensions. The main
diff --git a/documentation/articles/IntegratingAnExistingGWTWidget.asciidoc b/documentation/articles/IntegratingAnExistingGWTWidget.asciidoc
index bb35be2925..81889f9834 100644
--- a/documentation/articles/IntegratingAnExistingGWTWidget.asciidoc
+++ b/documentation/articles/IntegratingAnExistingGWTWidget.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[integrating-an-existing-gwt-widget]]
-Integrating an existing GWT widget
-----------------------------------
+= Integrating an existing GWT widget
 
 Integrating an existing, third party GWT widget usually just involves
 creating a regular Vaadin component with a client-side connector that
diff --git a/documentation/articles/IntegrationExperiences.asciidoc b/documentation/articles/IntegrationExperiences.asciidoc
index 2ae8ab3f43..02c62e36aa 100644
--- a/documentation/articles/IntegrationExperiences.asciidoc
+++ b/documentation/articles/IntegrationExperiences.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[integrating-vaadin-applications-with-other-technologies]]
-Integrating Vaadin Applications with other technologies
--------------------------------------------------------
+= Integrating Vaadin Applications with other technologies
 
 [[preface]]
 Preface
diff --git a/documentation/articles/LabelButtonsExpressively.asciidoc b/documentation/articles/LabelButtonsExpressively.asciidoc
index 0197e7d8dc..37d350eac9 100644
--- a/documentation/articles/LabelButtonsExpressively.asciidoc
+++ b/documentation/articles/LabelButtonsExpressively.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[label-buttons-expressively]]
-Label buttons expressively
---------------------------
+= Label buttons expressively
 
 People don’t read dialog box messages. They just click _“OK”_ or _“Yes”_
 or whichever button that seems like the right choice to make the dialog
diff --git a/documentation/articles/LettingTheUserDownloadAFile.asciidoc b/documentation/articles/LettingTheUserDownloadAFile.asciidoc
index 48b46354a9..4b595fc6de 100644
--- a/documentation/articles/LettingTheUserDownloadAFile.asciidoc
+++ b/documentation/articles/LettingTheUserDownloadAFile.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[letting-the-user-download-a-file]]
-Letting The User Download A File
---------------------------------
+= Letting The User Download A File
 
 Providing a file for download to the user might be trickier that what it
 seems - the file should be downloaded instead of just opened by the
diff --git a/documentation/articles/LoadTestingWithGatling.asciidoc b/documentation/articles/LoadTestingWithGatling.asciidoc
index d1aa9b89a7..2ec1c9e057 100644
--- a/documentation/articles/LoadTestingWithGatling.asciidoc
+++ b/documentation/articles/LoadTestingWithGatling.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[loading-testing-with-gatling]]
-Load testing with Gatling
--------------------------
+= Load testing with Gatling
 
 http://gatling.io[Gatling] is a powerful tool for load testing. Compared
 to WebDriver/Selenium/TestBench, it doesn't render the actual content,
diff --git a/documentation/articles/MVCBasicsInITMillToolkit.asciidoc b/documentation/articles/MVCBasicsInITMillToolkit.asciidoc
index 3f4f24d318..fb61ace2ca 100644
--- a/documentation/articles/MVCBasicsInITMillToolkit.asciidoc
+++ b/documentation/articles/MVCBasicsInITMillToolkit.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[mvc-basics-in-itmill-toolkit]]
-MVC Basics in IT Mill Toolkit
------------------------------
+= MVC Basics in IT Mill Toolkit
 
 The Goal
 ^^^^^^^^
diff --git a/documentation/articles/MarkRequiredFieldsAsSuch.asciidoc b/documentation/articles/MarkRequiredFieldsAsSuch.asciidoc
index 8bbafbec10..ce5f031931 100644
--- a/documentation/articles/MarkRequiredFieldsAsSuch.asciidoc
+++ b/documentation/articles/MarkRequiredFieldsAsSuch.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[mark-required-fields-as-such]]
-Mark required fields as such
-----------------------------
+= Mark required fields as such
 
 Don’t make your users guess which fields in your form are required. Mark
 them as such:
diff --git a/documentation/articles/OpeningAUIInAPopupWindow.asciidoc b/documentation/articles/OpeningAUIInAPopupWindow.asciidoc
index a9afde00ea..b8c72135e7 100644
--- a/documentation/articles/OpeningAUIInAPopupWindow.asciidoc
+++ b/documentation/articles/OpeningAUIInAPopupWindow.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[opening-a-ui-in-a-popup-window]]
-Opening a UI in a popup window
-------------------------------
+= Opening a UI in a popup window
 
 To open a new popup window in the browser showing another part of your
 application, you can use the new `BrowserWindowOpener` extension. Any
diff --git a/documentation/articles/OptimizingSluggishUI.asciidoc b/documentation/articles/OptimizingSluggishUI.asciidoc
index 4f4d98e60c..aaf7eeee25 100644
--- a/documentation/articles/OptimizingSluggishUI.asciidoc
+++ b/documentation/articles/OptimizingSluggishUI.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[optimizing-sluggish-ui]]
-Optimizing sluggish UI
-----------------------
+= Optimizing sluggish UI
 
 Is your Vaadin application becoming sluggish? Yes, this can happen - it
 is no secret. This can happen for every application, with every
diff --git a/documentation/articles/OptimizingTheWidgetSet.asciidoc b/documentation/articles/OptimizingTheWidgetSet.asciidoc
index 3862995c95..b06823ddf4 100644
--- a/documentation/articles/OptimizingTheWidgetSet.asciidoc
+++ b/documentation/articles/OptimizingTheWidgetSet.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[optimizing-the-widget-set]]
-Optimizing the widget set
--------------------------
+= Optimizing the widget set
 
 Vaadin contains a lot of components and most of those components
 contains a client side part which is executed in the browser. Together
diff --git a/documentation/articles/PackagingSCSSOrCSSinAnAddon.asciidoc b/documentation/articles/PackagingSCSSOrCSSinAnAddon.asciidoc
index c6efa1b06f..14532d6de6 100644
--- a/documentation/articles/PackagingSCSSOrCSSinAnAddon.asciidoc
+++ b/documentation/articles/PackagingSCSSOrCSSinAnAddon.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[packaging-scss-or-css-in-an-add-on]]
-Packaging SCSS or CSS in an add-on
-----------------------------------
+= Packaging SCSS or CSS in an add-on
 
 The add-on architecture of Vaadin enables you to easily create reusable
 components and share them with the world. The add-on can be of various
diff --git a/documentation/articles/ReadOnlyVsDisabledFields.asciidoc b/documentation/articles/ReadOnlyVsDisabledFields.asciidoc
index c3ea362d9a..09a0509eb7 100644
--- a/documentation/articles/ReadOnlyVsDisabledFields.asciidoc
+++ b/documentation/articles/ReadOnlyVsDisabledFields.asciidoc
@@ -9,8 +9,7 @@ layout: page
 This article was written before Vaadin 7.3, and is referring to the previous default theme, Reindeer. The visual appearance of read-only fields is different in the newer default theme, Valo. In Valo, read-only fields retain the border around the input field.
 
 [[read-only-vs-disabled-fields]]
-Read-only vs Disabled fields
-----------------------------
+= Read-only vs Disabled fields
 
 Vaadin input field components have both a _disabled_ and a _read-only_
 state (which can be set through the *setEnabled(false)* and
diff --git a/documentation/articles/RememberToTheSetTheLocale.asciidoc b/documentation/articles/RememberToTheSetTheLocale.asciidoc
index 613aaadb8e..1dc0e10dcd 100644
--- a/documentation/articles/RememberToTheSetTheLocale.asciidoc
+++ b/documentation/articles/RememberToTheSetTheLocale.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[remember-to-the-set-the-locale]]
-Remember to the set the locale
-------------------------------
+= Remember to the set the locale
 The Locale of an application or an individual component dictates the
 language and format used for displaying and parsing numbers and dates.
 This includes things like names of months, 12 or 24 hour time formats,
diff --git a/documentation/articles/RightAlignComparableNumericalFields.asciidoc b/documentation/articles/RightAlignComparableNumericalFields.asciidoc
index fc023c3ed2..0dd34d38ef 100644
--- a/documentation/articles/RightAlignComparableNumericalFields.asciidoc
+++ b/documentation/articles/RightAlignComparableNumericalFields.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[right-align-comparable-numeric-fields]]
-Right-align comparable numeric fields
--------------------------------------
+= Right-align comparable numeric fields
 
 In the table below, the various numerical fields are kind of hard to
 compare and easy misinterpret, because of the alignment of the values:
diff --git a/documentation/articles/ScalableWebApplications.asciidoc b/documentation/articles/ScalableWebApplications.asciidoc
index da2f02e7e4..3c49b20a1e 100644
--- a/documentation/articles/ScalableWebApplications.asciidoc
+++ b/documentation/articles/ScalableWebApplications.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[scalable-web-applications]]
-Scalable web applications
--------------------------
+= Scalable web applications
 
 [[introduction]]
 Introduction
diff --git a/documentation/articles/SendingEmailFromJavaApplications.asciidoc b/documentation/articles/SendingEmailFromJavaApplications.asciidoc
index 3d55f21765..abe04836ba 100644
--- a/documentation/articles/SendingEmailFromJavaApplications.asciidoc
+++ b/documentation/articles/SendingEmailFromJavaApplications.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[sending-email-from-java-applications]]
-Sending email from Java Applications
-------------------------------------
+= Sending email from Java Applications
 
 [[introduction]]
 Introduction
diff --git a/documentation/articles/SendingEventsFromTheClientToTheServerUsingRPC.asciidoc b/documentation/articles/SendingEventsFromTheClientToTheServerUsingRPC.asciidoc
index 75657de3db..67b16b0f5a 100644
--- a/documentation/articles/SendingEventsFromTheClientToTheServerUsingRPC.asciidoc
+++ b/documentation/articles/SendingEventsFromTheClientToTheServerUsingRPC.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[sending-events-from-the-client-to-the-server-using-RPC]]
-Sending events from the client to the server using RPC
-------------------------------------------------------
+= Sending events from the client to the server using RPC
 An RPC mechanism can be used to communicate from the client to the
 server. In effect, the client can call methods that are executed by the
 server component. The server component can then take appropriate action
diff --git a/documentation/articles/SettingAndReadingCookies.asciidoc b/documentation/articles/SettingAndReadingCookies.asciidoc
index 1027c60bbb..09ad066ca7 100644
--- a/documentation/articles/SettingAndReadingCookies.asciidoc
+++ b/documentation/articles/SettingAndReadingCookies.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[setting-and-reading-cookies]]
-Setting And Reading Cookies
----------------------------
+= Setting And Reading Cookies
 
 You can easily read and write
 http://en.wikipedia.org/wiki/HTTP_cookie[cookies] from both the server
diff --git a/documentation/articles/SettingAndReadingSessionAttributes.asciidoc b/documentation/articles/SettingAndReadingSessionAttributes.asciidoc
index 72db6bef11..1f38318cd0 100644
--- a/documentation/articles/SettingAndReadingSessionAttributes.asciidoc
+++ b/documentation/articles/SettingAndReadingSessionAttributes.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[setting-and-reading-session-attributes]]
-Setting and reading session attributes
---------------------------------------
+= Setting and reading session attributes
 
 Vaadin has a few different ways of storing data that should be
 accessible later. Which one you should use depends on the scope of the
diff --git a/documentation/articles/UseTooltipsToClarifyFunctions.asciidoc b/documentation/articles/UseTooltipsToClarifyFunctions.asciidoc
index 86e7571555..68ad8f996d 100644
--- a/documentation/articles/UseTooltipsToClarifyFunctions.asciidoc
+++ b/documentation/articles/UseTooltipsToClarifyFunctions.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[use-tooltips-to-clarify-functions]]
-Use tooltips to clarify functions
----------------------------------
+= Use tooltips to clarify functions
 
 Even when clearly labelled, the action performed by a button might not
 be clear enough to the user. This is especially common when space or
diff --git a/documentation/articles/UsingAJavaScriptLibraryOrAStyleSheetInAnAddOn.asciidoc b/documentation/articles/UsingAJavaScriptLibraryOrAStyleSheetInAnAddOn.asciidoc
index fe7f864359..1e481941f7 100644
--- a/documentation/articles/UsingAJavaScriptLibraryOrAStyleSheetInAnAddOn.asciidoc
+++ b/documentation/articles/UsingAJavaScriptLibraryOrAStyleSheetInAnAddOn.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-a-javascript-library-or-a-style-sheet-in-an-addon]]
-Using a JavaScript library or a style sheet in an add-on
---------------------------------------------------------
+= Using a JavaScript library or a style sheet in an add-on
 
 Including style sheets or JavaScript files in your add-ons or as a part
 of your application can now be done by adding a `@StyleSheet` or
diff --git a/documentation/articles/UsingBeanValidationToValidateInput.asciidoc b/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
index a33ad651f7..d87e74d110 100644
--- a/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
+++ b/documentation/articles/UsingBeanValidationToValidateInput.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-bean-validation-to-validate-input]]
-Using Bean Validation to validate input
----------------------------------------
+= Using Bean Validation to validate input
 
 Before you get started with Bean Validation you need to download a Bean
 Validation implementation and add it to your project. You can find one
diff --git a/documentation/articles/UsingDeclarativeServices.asciidoc b/documentation/articles/UsingDeclarativeServices.asciidoc
index 7997c07993..38cd2a20fa 100644
--- a/documentation/articles/UsingDeclarativeServices.asciidoc
+++ b/documentation/articles/UsingDeclarativeServices.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-declarative-services]]
-Using declarative services
---------------------------
+= Using declarative services
 
 Declarative Services (DS) are very common to define OSGi services. The
 DS bundle scans all bundles (extender pattern), parses the component
diff --git a/documentation/articles/UsingFontIcons.asciidoc b/documentation/articles/UsingFontIcons.asciidoc
index 7713f48c74..73f99b275f 100644
--- a/documentation/articles/UsingFontIcons.asciidoc
+++ b/documentation/articles/UsingFontIcons.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-font-icons-in-vaadin-7.2]]
-Using font icons in Vaadin 7.2
-------------------------------
+= Using font icons in Vaadin 7.2
 
 A “font icon” is an icon that is a glyph (essentially a character) from
 a font. A font that is made for this purpose (containing only icons) is
diff --git a/documentation/articles/UsingParametersWithViews.asciidoc b/documentation/articles/UsingParametersWithViews.asciidoc
index a2c8ac5939..3afa1ebc5f 100644
--- a/documentation/articles/UsingParametersWithViews.asciidoc
+++ b/documentation/articles/UsingParametersWithViews.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-parameters-with-views]]
-Using parameters with Views
----------------------------
+= Using parameters with Views
 
 When the Navigator API is in use, one can pass "parameters" to Views in
 the URI fragment.
diff --git a/documentation/articles/UsingPolling.asciidoc b/documentation/articles/UsingPolling.asciidoc
index b92b96a901..6889da048a 100644
--- a/documentation/articles/UsingPolling.asciidoc
+++ b/documentation/articles/UsingPolling.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-polling]]
-Using Polling
--------------
+= Using Polling
 To set up polling for your UI, you only need to set a poll interval
 using `UI.setPollInterval(timeout)`. By doing this the browser will poll
 the server each "timeout" ms and retrieve any possibly pending changes.
diff --git a/documentation/articles/UsingRPCFromJavaScript.asciidoc b/documentation/articles/UsingRPCFromJavaScript.asciidoc
index 5e7cea7f97..21c5a6f809 100644
--- a/documentation/articles/UsingRPCFromJavaScript.asciidoc
+++ b/documentation/articles/UsingRPCFromJavaScript.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-rpc-from-javascript]]
-Using RPC from JavaScript
--------------------------
+= Using RPC from JavaScript
 
 This tutorial continues where
 link:IntegratingAJavaScriptComponent.asciidoc[Integrating a JavaScript
diff --git a/documentation/articles/UsingRPCToSendEventsToTheClient.asciidoc b/documentation/articles/UsingRPCToSendEventsToTheClient.asciidoc
index fffcbec6bc..4bbdbc268f 100644
--- a/documentation/articles/UsingRPCToSendEventsToTheClient.asciidoc
+++ b/documentation/articles/UsingRPCToSendEventsToTheClient.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-rpc-to-send-events-to-the-client]]
-Using RPC to send events to the client
---------------------------------------
+= Using RPC to send events to the client
 
 An RPC mechanism can be used to communicate from the server to the
 client. In effect, the server-side component can call methods that are
diff --git a/documentation/articles/UsingServerInitiatedEvents.asciidoc b/documentation/articles/UsingServerInitiatedEvents.asciidoc
index 4857817c2a..cad64f794c 100644
--- a/documentation/articles/UsingServerInitiatedEvents.asciidoc
+++ b/documentation/articles/UsingServerInitiatedEvents.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-server-initiated-events]]
-Using server-initiated events
------------------------------
+= Using server-initiated events
 
 The traditional way of communicating with the server is always client
 initiated. Whenever the user interacts with the application so a server
diff --git a/documentation/articles/UsingURIFragments.asciidoc b/documentation/articles/UsingURIFragments.asciidoc
index 2328d91dde..389125d605 100644
--- a/documentation/articles/UsingURIFragments.asciidoc
+++ b/documentation/articles/UsingURIFragments.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-uri-fragments]]
-Using URI fragments
--------------------
+= Using URI fragments
 
 [[reading-fragment-when-initializing-ui]]
 Reading Fragment when Initializing UI
diff --git a/documentation/articles/UsingVaadinCDIWithJAASAuthentication.asciidoc b/documentation/articles/UsingVaadinCDIWithJAASAuthentication.asciidoc
index 0553f47a4e..0defaa5a78 100644
--- a/documentation/articles/UsingVaadinCDIWithJAASAuthentication.asciidoc
+++ b/documentation/articles/UsingVaadinCDIWithJAASAuthentication.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-vaadin-cdi-with-jaas-authentication]]
-Using Vaadin CDI with JAAS authentication
------------------------------------------
+= Using Vaadin CDI with JAAS authentication
 
 Servlet 3.0 is awesome, so is CDI. They work well and are a joy to set
 up. Even adding the Vaadin Navigator to the mix isn't an issue, since
diff --git a/documentation/articles/UsingVaadinInIBMDomino.asciidoc b/documentation/articles/UsingVaadinInIBMDomino.asciidoc
index 35ffcbc8d4..abd0f03f60 100644
--- a/documentation/articles/UsingVaadinInIBMDomino.asciidoc
+++ b/documentation/articles/UsingVaadinInIBMDomino.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[using-vaadin-in-ibm-domino]]
-Using Vaadin In IBM Domino
---------------------------
+= Using Vaadin In IBM Domino
 
 Vaadin can be used as a UI technology in Domino. This page will contain
 the instruction how to setup the development environment and to get
diff --git a/documentation/articles/Vaadin7SpringSecurityBaseAuthentification.asciidoc b/documentation/articles/Vaadin7SpringSecurityBaseAuthentification.asciidoc
index 4350274539..032dbd9576 100644
--- a/documentation/articles/Vaadin7SpringSecurityBaseAuthentification.asciidoc
+++ b/documentation/articles/Vaadin7SpringSecurityBaseAuthentification.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-7-spring-security-base-authentication]]
-Vaadin 7 + Spring Security (base authentication)
-------------------------------------------------
+= Vaadin 7 + Spring Security (base authentication)
 
 Vaadin 7 is easy to integrate with Spring Security. You should configure only
 2 files. First - web.xml and second one spring-security.xml (user
diff --git a/documentation/articles/VaadinCDI.asciidoc b/documentation/articles/VaadinCDI.asciidoc
index 6c0c94fae4..d9cb315d96 100644
--- a/documentation/articles/VaadinCDI.asciidoc
+++ b/documentation/articles/VaadinCDI.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-cdi]]
-Vaadin CDI
-----------
+= Vaadin CDI
 
 During these tutorials we will be solving a number of common problems
 when using the https://vaadin.com/directory/component/vaadin-cdi[Vaadin CDI plugin].
diff --git a/documentation/articles/VaadinOnGrailsCreateProjectInIntelliJIDEA.asciidoc b/documentation/articles/VaadinOnGrailsCreateProjectInIntelliJIDEA.asciidoc
index 336a65e405..584ed4a18d 100644
--- a/documentation/articles/VaadinOnGrailsCreateProjectInIntelliJIDEA.asciidoc
+++ b/documentation/articles/VaadinOnGrailsCreateProjectInIntelliJIDEA.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-on-grails-with-intellij-idea]]
-Vaadin on Grails with IntelliJ IDEA
------------------------------------
+= Vaadin on Grails with IntelliJ IDEA
 
 _Versions used in this tutorial: Grails 2.3.x, Vaadin 7.1.x. News and
 updates about Vaadin on Grails are available on
diff --git a/documentation/articles/VaadinOnGrailsDatabaseAccess.asciidoc b/documentation/articles/VaadinOnGrailsDatabaseAccess.asciidoc
index 0b3f847773..1fdab5f15f 100644
--- a/documentation/articles/VaadinOnGrailsDatabaseAccess.asciidoc
+++ b/documentation/articles/VaadinOnGrailsDatabaseAccess.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-on-grails-database-access]]
-Vaadin on grails - Database access
-----------------------------------
+= Vaadin on grails - Database access
 
 _Versions used in this tutorial: Grails 2.3.x, Vaadin 7.1.x. News and
 updates about Vaadin on Grails are available on
diff --git a/documentation/articles/VaadinOnGrailsMultipleUIs.asciidoc b/documentation/articles/VaadinOnGrailsMultipleUIs.asciidoc
index 26b0cab680..8694c7bcb7 100644
--- a/documentation/articles/VaadinOnGrailsMultipleUIs.asciidoc
+++ b/documentation/articles/VaadinOnGrailsMultipleUIs.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-on-grails-multiple-uis]]
-Vaadin on grails - multiple UIs
--------------------------------
+= Vaadin on grails - multiple UIs
 
 _Versions used in this tutorial: Grails 2.3.x, Vaadin 7.1.x. News and
 updates about Vaadin on Grails are available on
diff --git a/documentation/articles/VaadinScalabilityTestingWithAmazonWebServices.asciidoc b/documentation/articles/VaadinScalabilityTestingWithAmazonWebServices.asciidoc
index a99affa12d..9b230d13a0 100644
--- a/documentation/articles/VaadinScalabilityTestingWithAmazonWebServices.asciidoc
+++ b/documentation/articles/VaadinScalabilityTestingWithAmazonWebServices.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-scalability-testing-with-amazon-web-services]]
-Vaadin scalability testing with Amazon Web Services
----------------------------------------------------
+= Vaadin scalability testing with Amazon Web Services
 
 This article explains how you can test the scalability of your
 application in the Amazon Web Services (AWS) cloud. The AWS services
diff --git a/documentation/articles/VaadinSpringTips.asciidoc b/documentation/articles/VaadinSpringTips.asciidoc
index 490d2ec370..58560bf034 100644
--- a/documentation/articles/VaadinSpringTips.asciidoc
+++ b/documentation/articles/VaadinSpringTips.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[vaadin-spring-tips]]
-Vaadin Spring tips
-------------------
+= Vaadin Spring tips
 
 [[vaadin-spring-boot-configuration-properties]]
 Vaadin Spring (Boot) configuration properties
diff --git a/documentation/articles/VaadinTutorialForSwingDevelopers.asciidoc b/documentation/articles/VaadinTutorialForSwingDevelopers.asciidoc
index 946d2433d9..d7bc0702dd 100644
--- a/documentation/articles/VaadinTutorialForSwingDevelopers.asciidoc
+++ b/documentation/articles/VaadinTutorialForSwingDevelopers.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[a-hitchhikers-guide-to-convert-aswing-appto-modern-web-app]]
-A hitchhiker's guide to convert a Swing app to modern web app
--------------------------------------------------------------
+= A hitchhiker's guide to convert a Swing app to modern web app
 
 [[intro]]
 Intro
diff --git a/documentation/articles/ValoExamples.asciidoc b/documentation/articles/ValoExamples.asciidoc
index e95a742dc1..5c6245ee9d 100644
--- a/documentation/articles/ValoExamples.asciidoc
+++ b/documentation/articles/ValoExamples.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[valo-examples]]
-Valo examples
--------------
+= Valo examples
 
 These are some sample looks for the Valo theme. You can use these as-is,
 as a starting point, or while learning Valo.
diff --git a/documentation/articles/ValoThemeGettingStarted.asciidoc b/documentation/articles/ValoThemeGettingStarted.asciidoc
index 99431b2107..9c9f0fadce 100644
--- a/documentation/articles/ValoThemeGettingStarted.asciidoc
+++ b/documentation/articles/ValoThemeGettingStarted.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[valo-theme-getting-started]]
-Valo theme - Getting started
-----------------------------
+= Valo theme - Getting started
 
 To create your own variation of the Valo theme, start by creating a new
 custom theme for your project. See
diff --git a/documentation/articles/ViewChangeConfirmations.asciidoc b/documentation/articles/ViewChangeConfirmations.asciidoc
index 9075ace843..f9a83b645f 100644
--- a/documentation/articles/ViewChangeConfirmations.asciidoc
+++ b/documentation/articles/ViewChangeConfirmations.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[view-change-confirmations]]
-View change confirmations
--------------------------
+= View change confirmations
 
 The `Navigator` API provides ways to prevent the user from navigating away
 from a view in some cases, usually when the view has some unsaved
diff --git a/documentation/articles/VisuallyDistinguishPrimaryActions.asciidoc b/documentation/articles/VisuallyDistinguishPrimaryActions.asciidoc
index 6e06ae0ece..e393c4c0a5 100644
--- a/documentation/articles/VisuallyDistinguishPrimaryActions.asciidoc
+++ b/documentation/articles/VisuallyDistinguishPrimaryActions.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[visually-distinguish-primary-actions]]
-Visually distinguish primary actions
-------------------------------------
+= Visually distinguish primary actions
 
 Most forms and dialogs have at least two actions that can be performed,
 such as _Submit/Cancel_, _Save/Revert_ or _Yes/No_. Quite often, there
diff --git a/documentation/articles/WidgetStylingUsingOnlyCSS.asciidoc b/documentation/articles/WidgetStylingUsingOnlyCSS.asciidoc
index 97c11f9e27..ca37247836 100644
--- a/documentation/articles/WidgetStylingUsingOnlyCSS.asciidoc
+++ b/documentation/articles/WidgetStylingUsingOnlyCSS.asciidoc
@@ -5,8 +5,7 @@ layout: page
 ---
 
 [[widget-styling-using-only-css]]
-Widget styling using only CSS
------------------------------
+= Widget styling using only CSS
 
 The preferred way of styling your widget is to only use static CSS
 included in the theme's styles.css file. For information on how to
diff --git a/documentation/migration/migrating-to-vaadin8.asciidoc b/documentation/migration/migrating-to-vaadin8.asciidoc
index 51abcb009c..caae0f3e31 100644
--- a/documentation/migration/migrating-to-vaadin8.asciidoc
+++ b/documentation/migration/migrating-to-vaadin8.asciidoc
@@ -4,7 +4,7 @@ order: 1
 layout: page
 ---
 [[migration]]
-== Migration from Framework 7 to Framework 8
+= Migration from Framework 7 to Framework 8
 
 Most Vaadin Framework 7 applications will need some changes when migrating to Vaadin Framework 8.
 To make migration from version 7 to 8 as straightforward as possible, Vaadin Framework 8 ships with compatibility packages that include all the old features and APIs that have changed between versions.