<?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>5179</bug_id>
          
          <creation_ts>2007-10-10 23:35:16 +0000</creation_ts>
          <short_desc>Editorial: make it easier to find &quot;list&quot; and &quot;union&quot; from the toc</short_desc>
          <delta_ts>2009-07-15 21:27:50 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>XML Schema</product>
          <component>Datatypes: XSD Part 2</component>
          <version>1.1 only</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>cluster: presentation</status_whiteboard>
          <keywords>resolved</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Noah Mendelsohn">noah_mendelsohn</reporter>
          <assigned_to name="C. M. Sperberg-McQueen">cmsmcq</assigned_to>
          <cc>cmsmcq</cc>
    
    <cc>David_E3</cc>
          
          <qa_contact name="XML Schema comments list">www-xml-schema-comments</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>17136</commentid>
    <comment_count>0</comment_count>
    <who name="Noah Mendelsohn">noah_mendelsohn</who>
    <bug_when>2007-10-10 23:35:16 +0000</bug_when>
    <thetext>We&apos;ve done a good job of making it easy in Schema 1.1 Part 2 to jump from the table of contents to descriptions of particular types like Integer.  Abstractions like &quot;List&quot; and &quot;Union&quot; seem equally important, but you have to more or less guess that they&apos;d be in the section &quot;2.4 Datatype Distinctions&quot;.

I can imagine serveral potential resolutions to this concern, any of which would be agreeable to me:

a) Add at least section 2.4.1 to the TOC.   The obvious thing to do would be to also add 2.4.2 Special vs. Primitive vs. Ordinary Datatypes; 2.4.3 Definition, Derivation, Restriction, and Construction; 2.4.4 Built-in vs. User-Defined Datatypes

b) Rearrange the sections in 2.4 so that &quot;list&quot; and &quot;union&quot; (and perhaps Atomic as well) are level 3 rather than level 4 headings, and then include them individually.  They seem like quite important abstractions in the type system, and they&apos;re buried quite deeply in the TOC hierarchy.

Other solutions might be agreeable to me too, but I strongly feel we should do something better than what we currently have.

Noah</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>17196</commentid>
    <comment_count>1</comment_count>
    <who name="David Ezell">David_E3</who>
    <bug_when>2007-10-14 19:25:56 +0000</bug_when>
    <thetext>*** Bug 4459 has been marked as a duplicate of this bug. ***</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>25089</commentid>
    <comment_count>2</comment_count>
    <who name="C. M. Sperberg-McQueen">cmsmcq</who>
    <bug_when>2009-05-09 14:24:14 +0000</bug_when>
    <thetext>A proposal illustrating a solution to this issue is at

    http://www.w3.org/XML/Group/2004/06/xmlschema-2/datatypes.b5179.html
    http://www.w3.org/XML/Group/2004/06/xmlschema-1/structures.b5179.html    

and is ready for WG action.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>25371</commentid>
    <comment_count>3</comment_count>
    <who name="David Ezell">David_E3</who>
    <bug_when>2009-05-29 16:36:38 +0000</bug_when>
    <thetext>RESOLUTION: adopt proposal for 5179 at http://www.w3.org/XML/Group/2004/06/xmlschema-2/datatypes.b5179.html

</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>25988</commentid>
    <comment_count>4</comment_count>
    <who name="C. M. Sperberg-McQueen">cmsmcq</who>
    <bug_when>2009-07-15 21:15:20 +0000</bug_when>
    <thetext>The change described in comment 2 has now been integrated into the status-quo documents.  I am accordingly marking this issue resolved.

Noah, as the originator, if you would signal your acceptance or rejection of this resolution by closing or reopening the bug in the usual manner, it would be helpful.  If the working group does not hear otherwise from you in the next two weeks, we will assume that you are content with the disposition of this comment.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>