From ed71cf74f6d8a31b885a3c5eefcce3b2fdd4df52 Mon Sep 17 00:00:00 2001
From: Tim Schaub <tim.schaub@gmail.com>
Date: Fri, 18 Mar 2016 17:52:16 -0600
Subject: [PATCH] Upgrade note on zIndex for drawFeature() styles

---
 changelog/upgrade-notes.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/changelog/upgrade-notes.md b/changelog/upgrade-notes.md
index 0f2d5cbf66..794ba37371 100644
--- a/changelog/upgrade-notes.md
+++ b/changelog/upgrade-notes.md
@@ -31,6 +31,8 @@ map.on('postcompose', function(event) {
 });
 ```
 
+A final change to the immediate rendering API is that `vectorContext.drawFeature()` calls are not "immediate" as well.  The drawing now occurs synchronously.  This means that any `zIndex` in a style passed to `drawFeature()` will be ignored.  To achieve `zIndex` ordering, order your calls to `drawFeature()` instead.
+
 #### Removal of `ol.DEFAULT_TILE_CACHE_HIGH_WATER_MARK`
 
 The `ol.DEFAULT_TILE_CACHE_HIGH_WATER_MARK` define has been removed. The size of the cache can now be defined on every tile based `ol.source`: