ISMIR and DAFx Tutorials 2012

h1. Wiki

 * [[Abstract]] for website

h2. Topics we need to cover in the tutorial

h3. Short form, e.g. for DAFx 90-min hands-off tutorial

Title: _Pointers to more effective software and data in audio research_

See also: "DAFx2012 Workshop":/projects/soundsoftware-management/wiki/DAFx2012_Workshop in private Management wiki

# Motivation - Reproducible research

# Software practice:

#* General good-practice overview (e.g. substance related to SWC "feedback loops")

#* Version control

#* Unit testing

#* Writing readable code

#* Working with others -- code reviews, pair programming etc

# Data management

#* Why manage data ? Data as first-class research output

#* Documenting data

#* Licensing - why CC0

#* Backing up data - where ? how much ?

#* Archiving data

#* Publishing data

#* Planning data management

#* EPSRC principles

# Software and data licences and copyright

# Open access and open publication

#* Journal policies

# Wrap up: Resources to review after the tutorial, links, handouts, etc

*Timing breakdown*

# Motivation and introduction - Mark P - 15 mins?

# Software - Chris - 30 mins?

#* Intro, best practices and how they hang together - feedback loops in research software

#* Readable code + Working with others

#* Version control

#* Unit testing

# Data management - Steve - 20 mins?

#* Intro, why manage data

#* The practice of it

#* Policy and principles

# Software and data licences and copyright - Chris? or merge with another section? - 10 mins?

# Open access, open publication, wrap up - Mark P - 10 mins?

# Q&A - 5 mins

Total 90 mins

*Materials we already have, that we can draw from*

* *Data*: "Data management presentation from SoundSoftware 2012":/documents/51 (15 mins + questions)

* *Data*: "Wiki material about planning and applying data management":/projects/sodamat/wiki/WP1_2_Online_Training_Material

* *Data*: "Publication policies":/projects/sodamat/wiki/Publishing_research_data

* *Motivation*: "SoundSoftware presentation from SoundSoftware 2012":/documents/40 (15 mins + questions)

* *Software*: "SoundSoftware Topics":http://soundsoftware.ac.uk/topics, particularly "Why version control?":http://soundsoftware.ac.uk/why-version-control, "What version control system should I use?":http://soundsoftware.ac.uk/version-control-what-system-to-use, "Open source software licences explained":http://soundsoftware.ac.uk/open-source-software-licences-explained, "Unit testing: Why bother?":http://soundsoftware.ac.uk/unit-testing-why-bother -- all far more verbose than we can be

* *Software*: "Software Carpentry agile development feedback loops":http://software-carpentry.org/4_0/softeng/agile/ or "here in Mike's slides":http://software-carpentry.org/blog/wp-content/uploads/2012/05/carpentry-conclusions.ppt -- about different scales of changes

* *Software*: "Handout about using our code site, from SSW2012":https://code.soundsoftware.ac.uk/attachments/463/handout.doc

* *Software*: Refer to "PW's talk":http://soundsoftware.ac.uk/soundsoftware2012#os1t2 from SSW2012 (and quote line about how unit testing would have taken time off PhD!)

h3. Longer form, e.g. for ISMIR 3-hour hands-on tutorial

If we want to do hand-on data management, do we need a local server ? Do we use the C4DM test repository ? Would any users actually have any data to work with anyway ?

h2. Things we must make

* *Leaflets*, *handouts* etc

** _What is version control?_ and why use it?

** _Unit testing and audio software_

** _Data management and policy_

** _Software licences and copyright_

** _Crib sheet for translating between version control systems_

* Evaluation form

h2. Things to remember & take

* Pop-up stand, any relevant posters etc

* For handouts, perhaps we should take PDFs and get them printed in a print shop in York rather than print here and carry them?

h2. Our plan of action

* By *Wednesday, September 5th* (SCR, 2pm, or in Mark's office?) we should be able to meet again, with slides having been prepared for the relevant sections by *Chris* and *Steve*

* *Luis* to produce handouts, 100% based on existing material, about: _Version control; why use it?_; _Software licences and copyright_; and _Project hosting recommendations_

* *Chris* to attempt a handout about _Unit testing and audio research_ -- but the slides take priority

h2. Notes

Number of people (from Damian)

bq. We would be expecting about 100ish people. We have about 120 registered for DAFx now, although some are guests who may not attend all sessions, and as it is the first day, some people may still be travelling. However I imagine most will take the opportunity to attend.