anchor.diff:  ----
   
   == Usage
  -For the most part you can use the API provided by the element.
  -This API is described in the documentation of each individual element.
  -Most notable changes introduced by the directives are the support for data-binding using the Angular 2 syntax and integration with the https://angular.io/docs/ts/latest/guide/forms.html[Angular forms].
  -
  -=== Data-Binding
  +For the most part, you can use the API provided by the element.
  +The API is described in the documentation of each individual element.
  +Most notable changes introduced by the directives are the support for data binding using the Angular 2 syntax and integration with the https://angular.io/docs/ts/latest/guide/forms.html[Angular forms].
  +
  +=== Data Binding
   You can use Angular 2 data-binding syntax with all the properties declared in the API documentation for each element.
   Some properties also support two-way data-binding. These are marked with [propertyname]#notifies# in the API documentation.
   
  
positive.code: 
  
  === Form Controls
  When using input-like elements ([elementname]#vaadin-combo-box#, [elementname]#vaadin-date-picker# or [elementname]#vaadin-upload#) inside an Angular form, you should normally use the [propertyname]#ngControl# attribute to track the state and validity.
  You can use two-way data-binding with [propertyname]#ngModel# as you would with other form fields.
  Simple validation like the [propertyname]#required# validator is supported as well as defining custom validators.
  
  See the example below on how to use [elementname]#vaadin-combo-box# as a form control with data-bound [propertyname]#items# property.
  [source]
  ----
  <vaadin-combo-box
  
negative.code: ----
  
  Before bootstrapping your application, you need to wait for the `WebComponentsReady` event.
  The event is fired after the HTML imports are done and the custom elements are upgraded and ready to be used.
  The following example demonstrates how to wrap your bootstrap code inside the event listener.
  
  [source,javascript]
  