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

Re: WANTED: A New Breed of Developer

  • From: Rick Jelliffe <rjelliffe@a...>
  • To: xml-dev@l...
  • Date: Mon, 09 Jun 2008 20:08:22 +1000

Re:  WANTED: A New Breed of Developer
bryan rasmussen wrote:
> I think for documentation you will almost often come outside the
> documenting facilities of a schema language, or the usage made of it.
> Also because there are various styles of documentation. The
> documentation structure that is most often used for XML mirrors the
> hierarchical nature of the format, I don't actually think I've ever
> found that useful. Documentation probably is better if it is a
> document, with some sort of introduction, a look at the overall logic
> of the language somewhere at the top.
>
> The hierarchy of elements is the least interesting part of the documentation.
>
> Cheers,
> Bryan rasmussen
>   
Yes, and indeed the potential need for multiple use cases and multiple 
views of the document based on those use cases may be better served by 
multiple schemas and transformations. 

If the idea is to be user-centric about the documentation, then a fair 
place to start is by making sure the system is user-friendly.  So often 
it turns out that a company's internal formats are different from its 
external formats, and that the data in the external format only has the 
detailed semantics of the internal format.

In the LIXI standard here in Australia, they worked out a system where 
instead of documenting the elements, they provide the ability to view 
each stakeholder's individual take on the semantics of the elements. 
That way each stakeholder describes the data according to their 
vocabularies, and people who want to interchange can review whether in 
fact each other's data and assumptions is good enough.

Cheers
Rick Jelliffe


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]


PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.