<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>4862</bug_id>
          
          <creation_ts>2007-07-18 10:42:22 +0000</creation_ts>
          <short_desc>What&apos;s an XML outline?</short_desc>
          <delta_ts>2007-07-18 15:59:17 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WS-Policy</product>
          <component>Guidelines</component>
          <version>FPWD</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Ashok Malhotra">ashok.malhotra</reporter>
          <assigned_to name="Felix Sasaki">fsasaki</assigned_to>
          
          
          <qa_contact name="Web Services Policy WG QA List">public-ws-policy-qa</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>15852</commentid>
    <comment_count>0</comment_count>
    <who name="Ashok Malhotra">ashok.malhotra</who>
    <bug_when>2007-07-18 10:42:22 +0000</bug_when>
    <thetext>The guidelines document uses the words &quot;XML outline&quot;.  Where is this defined and if it is defined?  And how is it defined?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>15860</commentid>
    <comment_count>1</comment_count>
    <who name="Christopher Ferris">chrisfer</who>
    <bug_when>2007-07-18 15:59:17 +0000</bug_when>
    <thetext>Best Practice 6: Provide an XML definition

Assertion authors should provide an XML schema [XML Schema] definition to specify the syntax of an assertion. A reader-friendly description such as an XML outline (see below) is also useful.

An example of a specification that provides an XML Outline is the Web Services Reliable Messaging Policy document [Web Services Reliable Messaging Policy]. The definition of the outline syntax used in that specification is found in its Terminology section (1.1). As an example of the outline syntax in use, the following outline has been copied from the aforementioned specification.

&lt;example&gt;

RESOLUTION: close issue 4862 with the above text replacing BP 6 and its rationale with the text above
See http://www.w3.org/2007/07/18-ws-policy-irc#T15-58-39</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>