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

[Peterson, Peter F. (pf9)]

I think in general you should make your changes and we can comment. That is
one of the benefits of having subversion in place, as long as you don't make
all of these changes in one commit.

We've (Pete Jemian mostly) have been trying to figure out a good way to give
an overview of definitions and base classes, but haven't determined a good
way to do it without hand-writing (and syncing). Having a "lite" version
would be a welcome addition.

P^2


On 5/22/09 4:04 AM, "Nick Hauser" <nha at ansto.gov.au> wrote:

> 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.
>  
> 
> _______________________________________________
> NeXus-tech mailing list
> NeXus-tech at nexusformat.org
> http://lists.nexusformat.org/mailman/listinfo/nexus-tech