perfsonar-dev - Sample documents for given templates
Subject: perfsonar development work
List archive
- From: Loukik Kudarimoti <>
- To: "" <>
- Cc: GEANT2-JRA1 <>
- Subject: Sample documents for given templates
- Date: Fri, 08 Dec 2006 17:08:54 +0000
Hi,
When we sent the hand over document along with templates, we had attached only one sample document. In attachment are two more sample documents.
* RRD MA Functional Specification
* RRD MA Interface Specification
These are for samples for functional specification template and Interface Specification Template. The two documents have cross-references (and we expect documents for all services to have cross-references as well).
The documents are for illustrative purposes only at the moment. So, you might notice that the Interface specification is complete only for one functionality. Please use this as a guide and we suggest that extra focus be given to the sections that describe the rnc (Relax NG Compact) schema explanation and also that examples be given for all cases.
The rnc schemas themselves: The schemas definitions are in rnc. Each schema definitions holds good for a particular message accepted by the service (and not all messages). Schemas have to be written for both requests and replies. I wasn't very familiar with RNCs but to be honest, it didn't take me much time to use them as they are so simple. I made use of 'jing' to validate the schema syntax. 'trang' helps in conversions to xsd, etc. If you need any help with these, please feel free to contact me (or Jason, Martin). A tutorial for rnc can be found here: http://relaxng.org/compact-tutorial-20030326.html
Please NOTE: The audience for these schemas will be the testing team and the development teams working with analysis tools. So, please try to write up schemas which are as accurate as possible. This way, there is less room for erroneous requests and its easier for them to use our services.
Feel free to ask us any questions that you might have.
Regards,
Loukik.
Attachment:
RRD MA Interface Specification 1.1.pdf
Description: Adobe PDF document
Attachment:
RRD MA Functional Specification 1.2.pdf
Description: Adobe PDF document
- Sample documents for given templates, Loukik Kudarimoti, 12/08/2006
Archive powered by MHonArc 2.6.16.