2006/ws/policy ws-policy-guidelines.xml,1.23,1.24

Update of /sources/public/2006/ws/policy
In directory hutz:/tmp/cvs-serv27133

Modified Files:
	ws-policy-guidelines.xml 
Log Message:
Fix for 3982, minor editorial fix for use of "Assertion Author"

Index: ws-policy-guidelines.xml
===================================================================
RCS file: /sources/public/2006/ws/policy/ws-policy-guidelines.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- ws-policy-guidelines.xml	26 Dec 2006 19:03:25 -0000	1.23
+++ ws-policy-guidelines.xml	4 Jan 2007 20:20:15 -0000	1.24
@@ -104,30 +104,27 @@
         defined by different communities based upon domain-specific requirements of
         the web service.
         </p>
-	    <p>The focus of these guidelines is to capture best practices
-        and usage patterns for practitioners. It is a
+	    <p>The focus of these guidelines is to capture best
+        practices and usage patterns for practitioners. It is a
         complementary guide to the Framework and Attachments
-        specifications and primer. It is intended to provide
-        non-normative guidelines for:
+        specifications and the Primer. It is intended to provide
+        non-normative guidelines for WS-Policy Assertion Authors who
+        need to know the features of the language and understand the
+        requirements for describing policy assertions. Some of the
+        guidance for WS-Policy Assertion Authors can also be helpful
+        for:
+
         </p>
 	  		<ulist>
-				<item>
-					<p>WS-Policy expression authors who need to understand the
-          			syntax of the language and understand how to build consistent policy expressions,
-	 			    </p>
-				</item>
-				<item>
-					<p>Assertion Authors who need to know the features
-          			of the language and understand the requirements for
-         			 describing policy assertions.
-          			</p>
-				</item>
-			</ulist>
-		<p> Some of the guidance for authors can also be helpful for:
-			<ulist>
+			        <item>
+                                        <p>WS-Policy expression authors who need to understand 
+                                 the syntax of the language and understand how to build consistent 
+                                 policy expressions
+                                </p>
+                                </item>
 				<item>
 					<p>Consumers of policy expressions who need to understand
-        			the requirements contained in policy assertions,
+        			the requirements contained in policy assertions
          			</p>
 				</item>
 				<item>
@@ -135,8 +132,8 @@
          			 how to use the assertions authored by Assertion Authors
          			</p>
 				</item>
-			</ulist>
-		</p>
+                                
+                        </ulist>
 		<p>This document assumes a basic understanding of XML 1.0,
         Namespaces in XML, WSDL 1.1 and SOAP.
         </p>
@@ -231,7 +228,7 @@
 		
 		<p>There are already many examples in the industry that adhere to the above practices, such as <bibref ref="WS-RM-Policy"/>
       	and <bibref ref="WS-SecurityPolicy"/>. Some common characteristics from these documents may be considered as <emph>best practices</emph> for new Assertion Authors:
-      	</p>
+      	</p> 
 			<ulist>
 				<item>
 					<p>Specify both the syntax and the semantics of the assertions
@@ -1880,6 +1877,14 @@
 							and bug http://www.w3.org/Bugs/Public/show_bug.cgi?id=3983
 						</td>
 					</tr>
+
+						<tr>
+						<td>20070105</td>
+						<td>UY</td>
+						<td>Resolution of Issue <loc href="http://www.w3.org/Bugs/Public/show_bug.cgi?id=3982">3982</loc>
+                                                    Based on <loc href="http://www.w3.org/2006/12/06-ws-policy-irc#T18-55-00)">Minutes for resolution</loc>, Minor formatting for consistent use of the term "Assertion Author"
+						</td>
+					</tr>
 				</tbody>
 			</table>
 		</inform-div1>

Received on Thursday, 4 January 2007 20:20:35 UTC