[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: Joe English <jenglish@f...>
• To: xml-dev@l...
• Date: Thu, 12 Oct 2000 09:55:36 -0700

Rick JELLIFFE wrote:
>
> So would people be happier with
>   * a much more comprehensive Primer
>   * splitting the Structures draft into two or three parts that were
>      more self contained
>   * a much terser algorithmic/logical treatment of the subject, less
>      comprehensible to Joe Database but smaller and more precise
>   * a rewrite of structures based on the concrete syntax rather than
>       having the abstract components first

I'd be much happier with approach (3): a terse,
formal specification.  Section 5 ("Formal Model for RDF")
in the RDF M&S REC and most of the XPATH spec are good examples.

Approach (1), a comprehensive Primer, is no doubt a good
thing too, but it should IMHO be a separate document.
Including too many explanatory examples tends to clutter
up specifications and makes them harder to navigate.
The target audience will only need to go through
the tutorial material once or twice, but may need to
revisit the meat of the spec again and again for 
years to come.


--Joe English

  jenglish@f...

• References:
  • Re: Improved writing -- who's going to pay for it?
    • From: Rick JELLIFFE <ricko@g...>
  • RE: Improved writing -- who's going to pay for it?
    • From: Linda van den Brink <lvdbrink@b...>

• Prev by Date: XSLT hierarchy to flat
• Next by Date: Re: ISO and W3C interaction
• 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