[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Improved writing -- who's going to pay for it?

• From: Wayne Steele <xmlmaster@h...>
• To: xml-dev@l...
• Date: Fri, 13 Oct 2000 12:48:20 -0700 (PDT)

I agree that this is an excellent model for future spec work.
I would love to see something like this coming out of the W3C.
You could have:

   /*!-- the actual specs released --*/
   Spec.xml                 (normative)
   SpecCommentary.xml       (informative, approved by WG)
   SpecEditorsNotes.xml     (non-normative, approved only by the Editor)

   /*!-- some standard stylesheets, used by multiple WGs --*/
   Browser_View.xsl
   Print_Normative_Only.xsl
   Print_As_Gloss.xsl
   Print_As_Footnotes.xsl

   /*!-- Rather short files to point your browser at for different views.
        Pretty much just identifies the Source Doc, and has a list of
        Modifying Docs.     --*/
   View_Spec.html
   View_Spec+Commentary.html
   View_Spec+Notes.html
   View_Spec+Commentary+Notes.html

   It would then be trivial for me to pass around 
"Waynes_private_comments_on_spec.xml" to my friends, who could view it the 
same way.

Tim Bray did pretty close to that about, what, 2.5 years ago?
And he didn't even have XSLT.


-Wayne Steele


>From: Linda van den Brink <lvdbrink@b...>
...
>Another idea could be to have the informative
>docs in the form of explanatory comments on the actual spec document, like
>Tim Bray's Annotated XML.
>

_________________________________________________________________________
Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com.

Share information about yourself, create your own public profile at 
http://profiles.msn.com.

• Follow-Ups:
  • RE: Improved writing -- who's going to pay for it?
    • From: "Eve L. Maler" <eve.maler@e...>

• Prev by Date: RE: standards body parallel
• Next by Date: RE: standards body parallel
• Previous by thread: Re: Improved writing -- who's going to pay for it?
• Next by thread: RE: Improved writing -- who's going to pay for it?
• Index(es):
  • Date
  • Thread