Wiki » History » Version 25

Version 24 (Chris Cannam, 2012-08-29 02:32 PM) → Version 25/48 (Chris Cannam, 2012-08-29 02:32 PM)

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 - 30 mins?
#* Intro, best practices and how they hang together
#* Version control
#* Unit testing
#* Readable code + Working with others
# Data management - 20 mins?
#* Intro, why manage data
#* The practice of it
#* Policy and principles
# Software and data licences and copyright - 10 mins?
# Open access, open publication, wrap up - 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 2012":https://code.soundsoftware.ac.uk/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

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_