SoundSoftware Code Site

h1. Help for this site

This is a code-repository and project management site for software development carried out in the UK academic audio and music research field.

Run by "SoundSoftware.ac.uk":http://soundsoftware.ac.uk, it is intended to provide a useful facility for researchers who are making software in the course of their work, and for anyone who wishes to make use of such software in the future.  We provide project management and hosting for source code, either published or private.

Although we welcome all audio and music researchers in the UK, we do encourage you to ensure that your follow the proper institutional protocols for managing your work and be careful to respect copyright and your institution's terms and conditions.  If source code control and other facilities are provided by your institution, please, use them; we are also producing documentation and other resources that we hope will help you to do that, so do keep an eye on our "general website":http://soundsoftware.ac.uk/.

h2. What facilities do we provide?

This server uses the "Redmine":http://redmine.org/ project management system, with source code repositories managed using the "Mercurial":http://mercurial.selenic.com distributed version control system.  Mercurial is a friendly, popular and modern system which is very effective for managing change histories in source code and much accompanying material.  (It is not so well suited to storing bulk data such as audio test data sets: we hope to provide additional facilities for those.) 

Documentation for Redmine is available in the "Redmine Guide":http://www.redmine.org/guide, and an introductory tutorial about Mercurial can be found at "hginit.com":http://hginit.com, with a number of usage tips at "hgtip.com":http://hgtip.com.  We are going to produce more tutorial material during the coming months.

If you have some existing code or other material which you would like to import into a project on this site, we can help you -- in particular, we can easily load data into your Mercurial repository from existing files or from other version control systems for you.  Just drop us a line.

h2. How to contact us

This site manages many software projects run by different people.  But one project here is different—the "SoundSoftware.ac.uk Project":https://code.soundsoftware.ac.uk/projects/soundsoftware-site is used to manage the development and running of the site itself.  (This page you are reading now is part of the wiki for that project.)  The site is developed in the open, so you can use this project to follow progress and to provide feedback.

If you are having problems with this site, please either:

* use the "SoundSoftware.ac.uk Project Forum":https://code.soundsoftware.ac.uk/projects/soundsoftware-site/boards ;

* submit a new bug report or feature request in the trackers for the "SoundSoftware.ac.uk Project":https://code.soundsoftware.ac.uk/projects/soundsoftware-site ; or

* send email to info@soundsoftware.ac.uk requesting help.

Before submitting a new bug report or feature request, please have a look at the "existing issues":https://code.soundsoftware.ac.uk/projects/soundsoftware-site/issues and see whether you can find anything already listed that matches your own requirement.