[NeXus-tech] NeXus documentation [SEC=UNCLASSIFIED]

[HAUSER, Nick]

Gentlemen,

Let me know if it's OK to do what I've proposed below in the
documentation:

Chapter 1 MediaWikiManual.xml
* rename MediaWiki Manual to Introduction
* delete NeXus Design - now appears in Chapter 7. NeXus classes


Chapter 7 ClassDefinitions.xml
You've got references to

    <xi:include href="BaseClassSections.xml"/>
    <xi:include href="ApplicationClassSections.xml"/>
    <xi:include href="ContributedClassSections.xml"/>

I imagine that you intended to reference the xsl transformed nxdl.xml
files in BaseClassSections.xml
* transform the nxdl.xml files and create the BaseClassSections.xml from
the current nxdl.xml files, or is it too early?
* Add an image of nxdl.xsd next to the tabular example 
* Once the NeXus.xsd is complete, is there a way we can represent the
entire NeXus tree in a hierarchical way in an image, that isn't as
verbose as the normal xsd images?

* Has there been any more thought put into what goes into the
ClassDefinitions.xml, especially the description of type and units?

Cheers.  

Nick.

Nick Hauser
Bragg Institute, Building 82
Australian Nuclear Science and Technology Organisation PMB 1, Menai NSW
2234 AUSTRALIA

T +61 2 9717 9474
F +61 2 9717 9799
M 0417 418 542
E nick.hauser at ansto.gov.au    
www.ansto.gov.au/research/bragg_institute

Important: This transmission is intended only for the use of the
addressee. It is confidential and may contain privileged information or
copyright material. If you are not the intended recipient, any use or
further disclosure of this communication is strictly forbidden. If you
have received this transmission in error, please notify me immediately
by telephone and delete all copies of this transmission as well as any
attachments.