From: Pekka Hyvönen <pekka@vaadin.com>
Date: Fri, 17 Mar 2017 07:38:09 +0000 (+0200)
Subject: Update release notes for 8.1.0.alpha1 (#8863)
X-Git-Tag: 8.1.0.alpha1~1
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=ea2d386f3b49c0c67f6e9685b7e4d7868bdadc8e;p=vaadin-framework.git

Update release notes for 8.1.0.alpha1 (#8863)
---

diff --git a/all/src/main/templates/release-notes.html b/all/src/main/templates/release-notes.html
index 36ce1e4804..95d1c37acc 100644
--- a/all/src/main/templates/release-notes.html
+++ b/all/src/main/templates/release-notes.html
@@ -64,13 +64,8 @@
             a number of new features and bug fixes, as listed in the <a
                 href="#enhancements">list of enhancements</a> and <a
                 href="#changelog">change log</a> below.
-		This beta release contains breaking changes based on your feedback on the previous beta version,
-		and we may change things on future beta versions based on your feedback if necessary.
+		The API in this alpha version is not considered final and will change based on your feedback.
 	</p>
-	<p>	Special note for add-on developers: please test your add-on against 
-		Framework 8.0 and update your add-on as needed.
-		
-        </p>
 
         <!-- ================================================================ -->
         <h3 id="changelog">Change Log for Vaadin Framework @version@</h3>
@@ -87,154 +82,29 @@
             enhancements. Below is a list of the most notable changes:</p>
 
         <ul>
-            <li>New, simpler data binding API</li>
-            <li>Vaadin Framework is now based on Java 8</li>
-            <li>Vaadin Framework is using GWT 2.8, allowing client side code to use Java 8</li>
-            <li>Other Framework dependencies including Atmosphere have been upgraded</li>
-            <li>Easier to integrate web components using HTML imports (<tt>@HtmlImport</tt>), custom tag name support for <tt>AbstractJavaScriptComponent</tt> and more efficient transmission of shared state changes for JavaScript components</li>
-            <li>Context click events are now generated on iOS devices (<a href="https://github.com/vaadin/framework/issues/7387">#7387</a>)</li>
-            <li>Add-ons can use <tt>META-INF/services/com.vaadin.server.VaadinServiceInitListener</tt> to automatically hook into the initialization sequence of the framework</li>
+            <li>Components In Grid</li>
+            <li>HTML5 Drag and Drop support</li>
+            <li>TreeGrid and HierarchicalDataProvider</li>
         </ul>
 
-        <p>
-            The new data binding API replaces the old <tt>Container</tt>, <tt>Item</tt>, <tt>Property</tt>, <tt>FieldGroup</tt>,
-            <tt>Validator</tt>, <tt>Converter</tt> and related classes with new mechanisms.
-            Also components using those are replaced with updated implementations using the
-            new API, and the old data binding API and components have been moved to separate
-            compatibility packages for ease of migration.
-            For more details, see <a href="#incompatible">the list of incompatible changes</a> and <a href="#migrating">how to migrate
-            to Vaadin Framework 8</a>.
         </p>
 
         <p>
-            For enhancements introduced in Vaadin Framework 7.7, see the <a
-                href="http://vaadin.com/download/release/7.7/7.7.0/release-notes.html">Release
-                Notes for Vaadin Framework 7.7.0</a>.
+            For enhancements introduced in Vaadin Framework 8.0, see the <a
+                href="http://vaadin.com/download/release/8.0/8.0.0/release-notes.html">Release
+                Notes for Vaadin Framework 8.0.0</a>.
+            For migrating from previous framework versions, see <a href="#incompatible">the list of incompatible changes</a> and <a href="#migrating">how to migrate
+            to Vaadin Framework 8</a>.
         </p>
 
         <h2 id="incompatible">Incompatible or Behavior-altering Changes in @version@</h2>
         
-        <ul><h4>Compatibility and requirements</h4>
-            <li>Vaadin Framework now requires Java 8 or later and Servlet 3.0 or later</li>
-            <li>Support for older browsers (including Microsoft IE 8-10) and Windows Phone has been dropped</li>
-            <li>Support for Google App Engine has been dropped</li>
-            <li><a href="#supportedservers">Supported servers</a></li>
-        </ul>
-        <ul><h4>New Data Binding API related changes</h4>
-            <li>Components using <tt>Property</tt>, <tt>Item</tt> or <tt>Container</tt> API have been reimplemented for the new API, except <tt>Tree</tt>, <tt>Table</tt>, <tt>TreeTable</tt> and <tt>Calendar</tt></li>
-            <li>Framework 7 versions of the components available in the v7 compatibility package for easier migration, <a href="#legacycomponents">see list of legacy components</a></li>
-            <li><tt>Binder</tt> is the replacement of <tt>FieldGroup</tt> and <tt>BeanFieldGroup</tt></li>
-            <li>Converters and Validators have been moved from Components to <tt>Binder</tt></li>
-            <li><tt>DataProvider</tt> is the replacement of <tt>Container</tt></li>
-            <ul>
-                <li><tt>ListDataProvider</tt> is the default in-memory data provider replacing <tt>IndexedContainer</tt>, <tt>BeanItemContainer</tt>, and <tt>BeanContainer</tt></li>
-                <li><tt>BackEndDataProvider</tt> is the basis for a lazy data provider</li>
-                <li><tt>SQLContainer</tt> is deprecated in v7 compatibility package and not directly replaced</li>
-                <li><tt>HierarchicalContainer</tt> is deprecated in v7 compatibility package and a replacement is planned for 8.1</li>
-            </ul>
-            <li>All components that list data are based on <tt>AbstractListing</tt></li>
-            <li>All <tt>AbstractListing</tt> components have been typed with the type of items they are listing</li>
-            <li><tt>HasValue</tt> replaces the <tt>Field</tt> interface as the basis for all field components</li>
-            <li>Field components based on <tt>HasValue</tt> may or may not accept null values, depending on each component. There is no <tt>setNullRepresentation</tt> anymore</li>
-            <li><tt>AbstractField::setRequired(boolean)</tt> has been replaced with:
-            <ul>
-                <li><tt>HasValue::setRequiredIndicatorVisible(boolean)</tt> which only makes the <tt>*</tt> required indicator visible for the component</li>
-                <li><tt>BindingBuilder::setRequired(String)</tt> adds a "not-empty" validator when used in <tt>Binder</tt> and makes the <tt>*</tt> required indicator visible</li>
-            </ul>
-            <li><tt>setItemCaptionGenerator</tt> in <tt>AbstractListing</tt> replaces <tt>setItemCaption</tt>, <tt>setItemCaptionMode</tt> and <tt>setItemCaptionPropertyId</tt> from <tt>AbstractSelect</tt></li>
-            <li><tt>setItemIconGenerator</tt> in <tt>AbstractListing</tt> replaces <tt>setItemIcon</tt> and <tt>setItemIconPropertyId</tt> from <tt>AbstractSelect</tt></li>
-        </ul>
-        <ul><h4>General API changes</h4>
-            <li>All listeners and most single method interfaces have been marked as <tt>@FunctionalInterface</tt></li>
-            <li>All components are now immediate, and <tt>AbstractComponent::setImmediate(boolean immediate)</tt> has been removed.</li>
-            <li>Read-only is now a feature for field components and has been moved from <tt>AbstractComponent</tt> to <tt>HasValue</tt> </li>
-            <li>Some deprecated/obsolete parts of API have been removed</li>
-            <li>All addListener/removeListener methods have been removed - replaced with the Java 8 friendly <tt>addClickListener()</tt>, <tt>addValueChangeListener()</tt> etc. instead</li>
-            <li>All new listeners are unregistered using a <tt>Registration</tt> object returned by <tt>addXyzListener()</tt> rather than with a separate <tt>removeXyzListener()</tt></li>
-            <li>Input prompts have been replaced with placeholders utilizing the related browser functionality, API is now <tt>setPlaceHolder</tt> instead of <tt>setInputPrompt</tt></li>
-            <li>Valo is the default theme, instead of Reindeer</li>
-            <li>Valo is the only included theme, all other themes have been moved to the <tt>compatiblity-themes</tt> package and are available as a separate dependency</li>
-            <li><tt>SharedState</tt> and the getter methods for it have been added to each component, regardless of whether those are used for anything or not</li>
-            <li>The old liferay theme (Liferay 6.0 look) has been removed</li>
-            <li>FontAwesome icon constants have been deprecated, and will not be updated. It is replaced with <a href="https://vaadin.com/icons">Vaadin Icons</a> that are included in the Framework</li>
-            <li>It is no longer possible to configure a <tt>CurrentInstance</tt> to be automatically inherited into spawned threads.</li>
-        </ul>
-        <ul><h4>Component specific API changes</h4>
-            <li><tt>setDescription(String)</tt> now renders tooltip as inner text by default, instead of HTML. HTML can be still used by using <tt>setDescription(String, ContentMode)</tt></li>
-            <li><tt>com.vaadin.shared.ui.label.ContentMode</tt> has been moved into <tt>com.vaadin.shared.ui</tt></li>
-            <li><tt>DateField</tt> replaces old <tt>PopupDateField</tt></li>
-            <li><tt>DateField</tt> and <tt>InlineDateField</tt> are now based on Java 8 <tt>LocalDate</tt> instead of <tt>Date</tt></li>
-            <li><tt>DateTimeField</tt> and <tt>InlineDateTimeField</tt> based on Java 8 <tt>LocalDateTime</tt> are introduced for time selecting time (hour / minute / second) </li>
-            <ul><li><tt>DateField</tt> and <tt>InlineDateField</tt> don't support time anymore, meaning the highest resolution for those is <tt>DateResolution.DAY</tt></li>
-            <li><tt>Resolution</tt> for <tt>DateField</tt> and <tt>InlineDateField</tt> is replaced by <tt>DateResolution</tt> and <tt>DateTimeResolution</tt></li></ul>
-            <li><tt>OptionGroup</tt> has been removed and replaced by:</li>
-            <ul>
-                <li><tt>CheckBoxGroup</tt> replaces <tt>OptionGroup</tt> in multiselect mode</li>
-                <li><tt>RadioButtonGroup</tt> replaces <tt>OptionGroup</tt> in single select mode</li>
-                <ul><tt>OptionGroup::setItemEnabled(Object, boolean)</tt> has been replaced by <tt>setItemEnabledProvider</tt> that accepts a predicate</ul>
-            </ul>
-            <li><tt>TwinColSelect</tt> is always in multiselect mode</li>
-            <li><tt>ListSelect</tt> is always in multiselect mode</li>
-            <li><tt>Upload</tt> has a separate immediate mode <tt>setImmediateMode(boolean)</tt> replacing <tt>setImmediate</tt> and is now by default in immediate mode</li>
-            <li><tt>RichTextArea</tt> no longer receives a special "v-richtextarea-readonly" class when readonly, only the standard "v-readonly" class</li>
-            <li><tt>Grid</tt> has been typed to the bean type it is using and its columns are specified with a value provider callback instead of "propertyId"</li>
-            <li><tt>Grid</tt> Editor now uses <tt>Binder</tt> instead of <tt>FieldGroup</tt>, and doesn't support a <tt>FieldFactory</tt></li>
-            <li><tt>Grid</tt> selection API has been removed from component level to <tt>GridSelectionModel</tt> which is available via <tt>Grid::getSelectionModel()</tt></li>
-            <li><tt>Grid::setSelectionModel(GridSelectionModel)</tt> visibility has been changed from <tt>public</tt> to <tt>protected</tt> to reduce confusion with <tt>Grid::setSelectionMode</tt></li>
-        </ul>
-        <ul><h4>Client side widget specific API changes</h4>
-            <li><tt>VTextualDate</tt></li> widget class is removed and replaced by abstract <tt>VAbstractTextualDate</tt> class which is supposed to be inherited by concrete date field implementation widgets
-        </ul>
-        <ul><h4>Component specific visual changes</h4>
-            <li>The default width of <tt>Label</tt> is now undefined, matching other components</li>
-            <li>The default width for <tt>ComboBox</tt> pop-up is now 100 % (previously undefined)</li>
-            <li><tt>VerticalLayout</tt> has by default <tt>spacing = true</tt> and <tt>margin = true</tt></li>
-            <li><tt>HorizontalLayout</tt> has by default <tt>spacing = true</tt> and <tt>margin = false</tt></li>
-        </ul>
-        <ul><h4>Component specific declarative syntax changes</h4>
-            <li>Components in the compatibility packages now use the prefix <tt>vaadin7-"</tt> in declarative design files</li>
-            <li><tt>required-indicator-visible</tt> attribute replaces the <tt>required</tt> attribute</li>
-            <li><tt>placeholder</tt> attribute replaces the <tt>input-prompt</tt> attribute for input components</li>
-            <li><tt>multi-select</tt> attribute is no longer used for select components</li>
-            <li><tt>vaadin-option-group</tt> with attribute <tt>multi-select=true</tt> is replaced by <tt>v-check-box-group</tt></li>
-            <li><tt>vaadin-option-group</tt> with attribute <tt>multi-select=false</tt> is replaced by <tt>v-radio-button-group</tt></li>
-            <li><tt>immediate</tt> attribute is not used for any component</li>
-            <li><tt>read-only</tt> attribute is now only used for field components instead of all components</li>
-            <li><tt>vaadin-upload</tt> has a new attribute <tt>immediate-mode</tt> that replaces the removed <tt>immediate</tt> attribue</li>
-            <li><tt>vaadin-grid</tt> column elements don't have <tt>property-id</tt> attribute anymore. Columns aren't addressed by a property anymore but they have an id. So there is <tt>column-id</tt> attribute instead</li>
-            <li><tt>vaadin-grid</tt> doesn't have <tt>readonly</tt> attribute anymore. It  is replaced by <tt>selection-allowed</tt> attribute which has special meaning for a <tt>Grid</tt></li> 
-        </ul>
-        <ul id="legacycomponents"><h4>Legacy components in the v7 compatiblity package <tt>com.vaadin.v7.ui</tt> available as a separate dependency</h4>
-            <li><tt>Calendar</tt> - no replacement in 8</li>
-            <li><tt>CheckBox</tt></li>
-            <li><tt>ColorPicker</tt></li>
-            <li><tt>ColorPickerArea</tt></li>
-            <li><tt>ComboBox</tt></li>
-            <li><tt>CustomField</tt></li>
-            <li><tt>DateField</tt> - replaced in 8 by <tt>DateField</tt> and <tt>DateTimeField</tt></li>
-            <li><tt>Form</tt> - no replacement in 8</li>
-            <li><tt>Grid</tt> (and renderers)</li>
-            <li><tt>HorizontalLayout</tt></li>
-            <li><tt>InlineDateField</tt> - replaced in 8 by <tt>InlineDateField</tt> and <tt>InlineDateTimeField</tt></li>
-            <li><tt>Label</tt></li>
-            <li><tt>ListSelect</tt></li>
-            <li><tt>NativeSelect</tt></li>
-            <li><tt>OptionGroup</tt> - replaced by <tt>CheckBoxGroup</tt> (multiselection) and <tt>RadioButtonGroup</tt> (single selection)</li>
-            <li><tt>PasswordField</tt></li>
-            <li><tt>PopupDateField</tt> - replaced in 8 by <tt>DateField</tt> and <tt>DateTimeField</tt></li>
-            <li><tt>ProgressBar</tt></li>
-            <li><tt>ProgressIndicator</tt></li>
-            <li><tt>RichTextArea</tt></li>
-            <li><tt>Select</tt> - removed, use <tt>ComboBox</tt> for single selection and <tt>ListSelect</tt> for multiselection</li>
-            <li><tt>Table</tt> - no replacement in 8.0, use Grid.</li>
-            <li><tt>TextArea</tt></li>
-            <li><tt>TextField</tt></li>
-            <li><tt>Tree</tt> - no replacement in 8.0, planned for 8.1</li>
-            <li><tt>TreeTable</tt> - no replacement in 8.0, TreeGrid planned for 8.1</li>
-            <li><tt>TwinColSelect</tt></li>
-            <li><tt>VerticalLayout</tt></li>
-            <li><tt>Upload</tt></li>
-        </ul>
+        <li>The <tt>TreeGrid</tt> component replaces both <tt>TreeTable</tt> and <tt>Tree</tt> component</li>
+        <li>The <tt>HierarchicalDataProvider</tt> interface replaces <tt>Container.Hierarchical</tt> and <<tt>InMemoryHierarchicalDataProvider</tt> replaces <tt>HierarchicalContainer</tt></li>
+        <li>The <tt>DragSourceExtension</tt> and <tt>DropTargetExtension</tt> extensions replace the old DnD features</li>
+        
+        <h2>For incompatible or behaviour-altering changes in 8.0, please see <a href="https://vaadin.com/download/release/8.0/8.0.0/release-notes.html#incompatible">8.0 release notes</a></h2>
+        
                 
         <h3 id="knownissues">Known Issues and Limitations</h3>
         <ul>
@@ -262,8 +132,6 @@
                 </li>
             </ul>
             </li>
-            <li>Grid does not support adding components to cells. Instead light-weight Renderers can be
-                used to present and edit data.</li>
             <li>The Maven GWT compilation for <tt>Vaadin7WidgetSet</tt> requires at least 1G of memory, when using the <tt>vaadin-client-compability</tt> package. If compiled inside Eclipse, possibly even more.</li>
         </ul>