Style 20 Style 19 Style 18 Style 17 Style 16 Style 15 Style 14 Style 13 Style 12 Style 11 Style 10 Style 9 Style 8 Style 7 Style 6 Style 5 Style 4 Style 3 Style 2 Style 1
Login
No account yet? Register
 
Home arrow Documents arrow Development arrow How to Collaborate on Producing SPASE Descriptions
How to Collaborate on Producing SPASE Descriptions Print E-mail
Written by Jan Merka   
Friday, 24 August 2007
So, you would like to join and help with describing resources using the SPASE data model but of course you do not want to duplicate existing descriptions. Then read on to find where to get the latest revision of metadata and how to submit your changes.

Getting Metadata

Git Repository

The easiest and most convenient way of working with VHO/VMO SPASE descriptions is by employing a distributed source content management system called git. For more information about GIT, see an overview, the tutorial or the man pages.

The VMO and VHO teams develop the SPASE metadata as git projects that can be browsed using a git web interface or directly cloned using git-clone commands.

Git web interface to VHO/VMO-related projects: http://vmo.nasa.gov/scm/git

Clone metadata with ResourceID prefix spase://VHO:

git clone http://vmo.nasa.gov/scm/git/metadata/VHO.git

Clone metadata with ResourceID prefix spase://VMO:

git clone http://vmo.nasa.gov/scm/git/metadata/VMO.git

Download a TAR.GZ Package

The VHO/VMO metadata are also available as *.tar.gz packages of XML files with resource descriptions. Each resource description is kept in a separate XML file.

Download the latest metadata with ResourceID prefix spase://VHO.

Download the latest metadata with ResourceID prefix spase://VMO.

Submitting Changes

Repository Maintainer

Any changes to VHO and VMO metadata repositories should be submitted for inclusion to the maintainer This e-mail address is being protected from spam bots, you need JavaScript enabled to view it .

The Git Way

Git offers a variety of commands to manage projects in a repositories and to prepare patches for submitting to the repository maintainer. After making changes to your local repository clone, the modifications need to be saved with an explanatory log message, for example:

git-commit -a -m "Initial description of ST5 observatory resources" 

Then, a set of patches can be prepared against the original repository as

git-format-patch origin

Or against metadata as of August 20, 2007:

git-format-patch @{2007-08-20}

And finally to email all patches to the maintainer:

git send-email --to <email address> ./ 

For more information about GIT, see an overview, the tutorial or the man pages.

Using Other Versioning Systems

It is possible to maintain the metadata locally in a different versioning system, for example CVS, Subversion (SVN), bazaar-ng, etc, and use its tools to generate and email patches.

Without a Versioning System

If you do not employ any versioning system, you can either submit patches or complete XML files to be integrated in the VHO/VMO repositories. The changes will get merged with the name and email of the author so when other developers review the metadata project history, they will know who made the changes.

Last Updated ( Monday, 27 August 2007 )
 
Next >