This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 4862 - What's an XML outline?
Summary: What's an XML outline?
Status: RESOLVED FIXED
Alias: None
Product: WS-Policy
Classification: Unclassified
Component: Guidelines (show other bugs)
Version: FPWD
Hardware: PC Windows XP
: P2 normal
Target Milestone: ---
Assignee: Felix Sasaki
QA Contact: Web Services Policy WG QA List
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-07-18 10:42 UTC by Ashok Malhotra
Modified: 2007-07-18 15:59 UTC (History)
0 users

See Also:

Attachments

Description Ashok Malhotra 2007-07-18 10:42:22 UTC 
The guidelines document uses the words "XML outline".  Where is this defined and if it is defined?  And how is it defined?
Comment 1 Christopher Ferris 2007-07-18 15:59:17 UTC 
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.

<example>

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