From 0c02c6028251bd79a727e84c8ae99ea29adf512d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Victoria=20Mart=C3=ADnez=20de=20la=20Cruz?=
 <victoria@vmartinezdelacruz.com>
Date: Sat, 30 Aug 2014 15:27:22 -0300
Subject: [PATCH] Adds partial field deprecation note in the users guide

This change adds information to the getting started user guide
about the partial attribute deprecation/removal.

Change-Id: I97684ffa7766885990e433304c9b8118b41c3af5
Closes-Bug: #1350437
---
 .../os-zaqar-apiGettingStarted.xml            | 25 +++++++++++++++----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/doc/user-guide/zaqar-get-started/os-zaqar-apiGettingStarted.xml b/doc/user-guide/zaqar-get-started/os-zaqar-apiGettingStarted.xml
index 58a1df5ae..f093d8707 100644
--- a/doc/user-guide/zaqar-get-started/os-zaqar-apiGettingStarted.xml
+++ b/doc/user-guide/zaqar-get-started/os-zaqar-apiGettingStarted.xml
@@ -70,6 +70,12 @@
                         incubation.</para>
                 </revdescription>
             </revision>
+            <revision>
+                <date>2014-08-30</date>
+                <revdescription>
+                    <para>The <parameter>partial</parameter> attribute is no longer supported.</para>
+                </revdescription>
+            </revision>
         </revhistory>
     </info>
     <chapter xml:id="doc-change-history">
@@ -760,13 +766,22 @@ Location: /v1/queues/samplequeue</programlisting>
                     class="attribute">age</tag>, is added.</para>
             <para>The response body contains a list of resource paths
                 that correspond to each message submitted in the
-                request, in the same order as they were submitted. If
-                a server-side error occurs during the processing of
-                the submitted messages, a partial list is returned.
+                request, in the same order as they were submitted.</para>
+            <para>If a server-side error occurs during the processing
+                of the submitted messages, a partial list is returned.
                 The <parameter>partial</parameter> attribute is set to
                     <parameter>true</parameter>, and the client tries
-                to post the remaining messages again. The
-                    <parameter>body</parameter> attribute specifies an
+                to post the remaining messages again.
+            </para>
+            <important>
+                <para>The <parameter>partial</parameter> attribute has been deprecated in the v1.0 API
+                    and is not available in the v1.1 API.
+                    Drivers are now required to operate in a transactional manner.
+                    In other words, either all messages must be posted, or none of them.
+                </para>
+            </important>
+            <para>
+                The <parameter>body</parameter> attribute specifies an
                 arbitrary document that constitutes the body of the
                 message being sent.</para>
             <para>The following rules apply for the maximum size:<itemizedlist>