From 208758d7a93c73d887c4030990d457ef52466c0e Mon Sep 17 00:00:00 2001
From: =?utf8?q?Leif=20=C3=85strand?= <leif@vaadin.com>
Date: Sat, 14 Mar 2015 17:23:07 +0200
Subject: [PATCH] Add link to the push issues wiki page to the release notes
 (#17142)

Change-Id: I52d2a883f76bd673c8ca749246858f1e16e11679
---
 WebContent/release-notes.html | 41 ++++++++++++++++++++---------------
 1 file changed, 24 insertions(+), 17 deletions(-)

diff --git a/WebContent/release-notes.html b/WebContent/release-notes.html
index efae20187e..097d554feb 100644
--- a/WebContent/release-notes.html
+++ b/WebContent/release-notes.html
@@ -47,8 +47,7 @@
                     @version-minor@</a></li>
             <li><a href="#incompatible">Incompatible or Behavior-altering Changes in
                     @version-minor@</a></li>
-            <li><a href="#knownissues">Known Issues</a></li>
-            <li><a href="#limitations">Limitations</a></li>
+            <li><a href="#knownissues">Known Issues and Limitations</a></li>
             <li><a href="#vaadin">Vaadin Installation</a></li>
             <li><a href="#package">Package Contents</a></li>
             <li><a href="#migrating">Migrating from Vaadin 6</a></li>
@@ -137,16 +136,12 @@
             <li>Window's accessibility shortcut was moved to server-side. Now setCloseShortcut overrides the default value, while addCloseShortcut can be used to add more than one shortcut key for closing the window.
                 The protected value closeShortcut in Window was removed.</li>
         </ul>
-        <h3 id="knownissues">Known Issues</h3>
+        <h3 id="knownissues">Known Issues and Limitations</h3>
         <ul>
             <li>Drag'n'drop in a Table doesn't work on touch devices running
                 Internet Explorer (Windows Phone, Surface)
                 (<a href="http://dev.vaadin.com/ticket/13737">#13737</a>)
             </li>
-        </ul>
-
-        <h3 id="limitations">Limitations</h3>
-        <ul>
             <li><p>It is currently not possible to specify <tt>font-size</tt>
                 as <tt>em</tt> or <tt>%</tt>, or layout component sizes
                 with <tt>em</tt> (<a
@@ -155,17 +150,29 @@
                 because it results in fractional component sizes in many cases, which 
                 might cause unwanted 1px gaps between components.</p>
             </li>
-            <li>Push is currently not supported in portals (See <a
-                href="http://dev.vaadin.com/ticket/11493">#11493</a>)
-            </li>
-            <li>HTTP session can not be invalidated while using
-                push over websockets on Tomcat 7 (<a href="http://dev.vaadin.com/ticket/11721">#11721</a>)
-            </li>
-            <li>Cookies are not available while using websockets (<a
-                href="http://dev.vaadin.com/ticket/11808">#11808</a>)
+            <li>Up-to-date information about compatibility issues with push functionality is available in
+            <a href="https://vaadin.com/wiki/-/wiki/Main/Working+around+push+issues">this wiki page.</a>
+            <br />
+            The most prominent limitations are:
+            <ul>
+	            <li>HTTP proxies can prevent push requests from working
+	            properly. To mitigate the issues, avoid using streaming
+	            and configure your proxy so it allows response headers
+	            to pass through before the whole response is received. 
+	            <a href="http://dev.vaadin.com/ticket/17075">#17075</a>
+	            should make long-polling work seamlessly with all proxies.
+	            </li>
+	            <li>HTTP session can not be invalidated while using
+	                push over websockets on Tomcat 7 (<a href="http://dev.vaadin.com/ticket/11721">#11721</a>)
+	            </li>
+	            <li>Cookies are not available while using websockets (<a
+	                href="http://dev.vaadin.com/ticket/11808">#11808</a>)
+	            </li>
+	            <li>Push is currently not supported in portals (See <a
+	                href="http://dev.vaadin.com/ticket/11493">#11493</a>)
+	            </li>
+            </ul>
             </li>
-            <li>Not all proxies are compatible with websockets or streaming.
-                Use long polling to avoid these problems.</li>
         </ul>
 
         <h2 id="vaadin">Vaadin Installation</h2>
-- 
2.39.5