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

[Wayne Steele <xmlmaster@hotmail.com>]

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@baan.nl>
...
>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.