From 9f2473153a0259d9347b849695148e206dd43ed3 Mon Sep 17 00:00:00 2001
From: Thiago Paiva <thiagop@lsd.ufcg.edu.br>
Date: Tue, 9 Aug 2016 15:07:05 -0300
Subject: [PATCH] Refactor OneView dynamic allocation release notes

Adding some context and an overall instruction/orientation about the new feature
for ironic operators.

Change-Id: Ie5ae2d8982f01972484a7f7bba7937e599254902
---
 ...c-allocation-feature-2fd6b4df7943f178.yaml | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/releasenotes/notes/add-dynamic-allocation-feature-2fd6b4df7943f178.yaml b/releasenotes/notes/add-dynamic-allocation-feature-2fd6b4df7943f178.yaml
index 2f0aa9a6a5..ca5471a58f 100644
--- a/releasenotes/notes/add-dynamic-allocation-feature-2fd6b4df7943f178.yaml
+++ b/releasenotes/notes/add-dynamic-allocation-feature-2fd6b4df7943f178.yaml
@@ -1,5 +1,20 @@
 ---
 features:
-  - Adds Dynamic Allocation feature for the OneView drivers.
+  - OneView drivers now support dynamic allocation of nodes in OneView,
+    allowing for better resource sharing with non-OpenStack users since Server
+    Hardware will be allocated only when the node is scheduled to be used. To
+    enable the new allocation feature for a node, set the flag
+    ``dynamic_allocation=True`` on the node's ``driver_info``.
+    More information is available at
+    http://docs.openstack.org/developer/ironic/drivers/oneview.html.
 deprecations:
-  - Deprecates pre-allocation feature for the OneView drivers.
+  - Deprecates pre-allocation feature for the OneView drivers since it requires
+    resource allocation to Ironic prior to boot time, which makes Server
+    Hardware unavailable to non-OpenStack OneView users. Pre-allocation will
+    be removed in the OpenStack "P" release. All nodes with
+    ``dynamic_allocation=False`` set, or that don't have the ``dynamic_allocation``
+    flag set, will be assumed to be in pre-allocation. Users may use the REST API
+    or the ``ironic-oneview-cli`` to migrate nodes from pre-allocation to
+    dynamic allocation.
+    More information is available at
+    http://docs.openstack.org/developer/ironic/drivers/oneview.html.